﻿== CMD_DESCRIPTION_ACL ==
设置对象权限。

== CMD_USAGE_ACL ==
用法：

    cm ^acl (--^user=<用户名> | --^group=<组名称>)
           (-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<权限>[,...])[,...]
           <对象规格>

    --^user             用户名。
    --^group            组名称。
    -^allowed           启用指定的一项或多项权限。使用
                       逗号对各个权限进行分隔。（使用 'cm ^showpermissions'
                       可显示所有可用权限。）
    -^denied            拒绝指定的一项或多项权限。使用
                       逗号对各个权限进行分隔。（使用 'cm ^showpermissions'
                       可显示所有可用权限。）
    -^overrideallowed   覆盖允许的一项或多项权限。使用
                       逗号对各个权限进行分隔。（使用 'cm ^showpermissions'
                       可显示所有可用权限。）
    -^overridedenied    覆盖拒绝的一项或多项权限。使用
                       逗号对各个权限进行分隔。（使用 'cm ^showpermissions'
                       可显示所有可用权限。）
    对象规格         要设置权限的对象。
                       此命令的有效对象为：
                       存储库服务器、存储库、分支、变更集、标签、项
                       和属性。
                       （使用 'cm ^help ^objectspec' 可进一步了解规格。）

安全路径的特殊用法：
    cm ^acl [(--^user=<用户名> | --^group=<组名称>)
            (-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<权限>[,...])[,...]]
            [--^delete] [--^branches=[+ | -]<分支>[,...]]
            <规格>

    --^delete           删除安全路径。
                       请参阅“备注”以了解更多信息。
    --^branches         将安全路径权限设置为一个分支组。
                       使用逗号对各个分支进行分隔。
                       （可选）每个分支前面可添加 + 或 -
                       符号，从而指定在编辑时必须在列表中添加
                       还是删除某个分支。
                       请参阅“备注”以了解更多信息。
    规格               要设置权限的安全路径。

== CMD_HELP_ACL ==
为了配置权限，需要了解 Plastic SCM 安全机制的工作原理。
请查看《安全指南》以了解权限的工作原理：
https://www.plasticscm.com/download/help/securityguide

备注：

    此命令设置用户或组对于指定对象、存储库、分支、标签
    和/或服务器路径的权限。

    对象规格：
        （使用 'cm ^help ^objectspec' 可了解如何指定对象。）
        '^acl' 命令使用一种特殊类型的规格：安全路径。

        - 安全路径规格：
            ^path:server_path[#tag]
            示例：^path:/src/foo.c
                      ^path:/doc/pdf
                      ^path:/doc/pdf#documents

    权限操作：
        使用 -^allowed 和 -^denied 指定要设置的权限。
        使用 -^overrideallowed 和 -^overridedenied 参数指定
        要覆盖的权限。

        每个操作都需要一个权限列表（以逗号分隔）。

    权限名称：
        每个权限名称前面都带有 + 或 - 符号。
        + 符号表示设置权限，而 - 符号表示清除权限。
        要查看对象的权限，请使用 'cm ^showacl' 命令。

    覆盖的权限：
        使用 -^overrideallowed 和 -^overridedenied
        来覆盖权限可以绕过继承。
        这对于绕过在存储库或服务器级别设置的权限
        很有帮助。
        示例：
            cm ^acl --^user=vio -^allowed=+^ci -^overrideallowed=+^ci ^br:qa@test
            （允许用户 'vio' 在存储库 'test' 上的分支 'qa' 上签入，
            即使该用户的权限在存储库级别被拒绝也是如此。）

    服务器路径权限（又称“安全路径”）：
        - 允许为给定的服务器路径指定权限。
        - 在签入操作期间会检查这些权限。
        - 也可以在更新操作期间检查这些权限，
          并可以将这些权限用作一种防止某些目录和文件
          下载到工作区的方法。
        - 对于要签入的每一项，服务器都会尝试将项路径
          与安全路径匹配。如果匹配，则签入操作
          将检查是否可以签入该项。

        可为安全路径定义的权限
        如下：
            '^ci'、'^change'、'^add'、'^move'、'^rm'、'^read'

        对于任何涉及的项，如果权限检查不成功，
        则检入操作将回滚。

        要将安全路径权限设置为一个分支组，请使用
        --^branches 选项。
        示例：
          cm ^acl --^user=jo -^denied=+^ci ^path:/src#rule0 --^branches=main,main/rel0

        要编辑与安全路径关联的 ACL，该标记很有用。
        示例：
          cm ^acl --^user=jo -^denied=+^rm ^path:/src#rule0
          （如果没有标记，则需要再次指定
          分支列表。）

        安全路径的分支列表是可以编辑的。
        示例：
          cm ^acl ^path:/src#rule0 --^branches=-main,+main/rel1
          （从列表中删除 'main' 并添加 'main/rel1'。）

        要删除安全路径，请使用 --^delete 参数。
        示例：
          cm ^acl --^user=jo --^delete ^path:/src#rule0

    继承：
        继承是 Plastic SCM 3.0 时期的一种选项。
        这是高级选项，但几乎已弃用。
        该选项允许对象从任何其他对象继承权限，
        从而覆盖默认的继承关系。

        使用选项 -^cut 切断继承链。
        使用选项 -^cutncpy 切断并复制当前继承的
        权限。（这个选项受到 Windows 文件系统权限的启发，
        在 Windows 文件系统中可以切断继承关系但保留实际权限。）

        -^inherit 选项允许用户从对象规格继承。
        示例：'-^inherit=对象规格'

示例：

    cm ^acl --^user=danipen -^denied=+^ci ^rep:core
    （拒绝用户 'danipen' 在存储库 'core' 上签入。）

    cm ^acl --^group=developers -^allowed=+^view,-^read -^denied=+^chgperm ^br:main
    （该命令向 'main' 分支中的 'developers' 组
    授予查看权限、清除读取权限并拒绝 chgperm 权限。）

安全路径示例：

    cm ^acl --^group=devs -^denied=+^ci ^path:/server#rel --^branches=main,main/2.0
    （对于在分支 'main' 和 'main/2.0' 中与 '/server' 匹配的任何路径，
    该命令拒绝向 'devs' 组授予签入权限。创建标记 '#rel'
    是为了稍后能够进行引用。）

    cm ^acl ^path:/server#rel --^branches=-/main,+/main/Rel2.1
    （更新具有 'rel' 标记的安全路径 '/server'，
    删除 'main' 分支，并将分支 'main/Rel2.1' 添加到
    安全路径所应用到的分支组。就前面的示例而言，
    现在分支列表将包含 'main/Rel2.1' 和 'main/2.0'。）

    cm ^acl --^user=vsanchezm -^allowed=-^read -^overrideallowed=+^read ^path:/doc
    （删除授权给 'vsanchezm' 的 '^read' 权限，在 '/doc' 路径中对其进行覆盖。）

== CMD_DESCRIPTION_ACTIVATEUSER ==
激活许可的用户。

== CMD_USAGE_ACTIVATEUSER ==
用法：

    cm ^activateuser | ^au <用户名>[ ...][--^server=<存储库服务器规格>]

    用户名   要激活的一个或多个用户名。使用双引号 (" ")
                指定包含空格的用户名。使用空格
                对各个用户名进行分隔。

选项：
    --^server=<存储库服务器规格>  激活指定服务器中的用户。
                                如果未指定服务器，则在 client.conf 文件
                                中的默认服务器中执行命令。
                                （使用 'cm ^help ^objectspec' 可进一步了解
                                存储库服务器规格。）

== CMD_HELP_ACTIVATEUSER ==
备注：

    要激活用户，必须已事先禁用该用户。
    默认情况下，用户第一次在 Plastic SCM 中执行写操作时
    会被激活。仅当未超过最大用户数时，
    才会自动激活用户。

    有关停用 Plastic SCM 用户的更多信息，
    请参阅 'cm ^help ^deactivateuser' 命令。

示例：

    cm ^activateuser john
    cm ^activateuser david "mary collins"
    cm ^au peter --^server=localhost:8087

== CMD_DESCRIPTION_ADD ==
向版本控制中添加项。

== CMD_USAGE_ADD ==
用法：

    cm ^add [-^R | -^r | --^recursive] [--^silent] [--^ignorefailed]
           [--^skipcontentcheck] [--^coparent] [--^filetypes=<文件>] [--^noinfo]
           [--^format=<格式字符串>] [--^errorformat=<格式字符串>]
           <项路径>[ ...]

    项路径   要移动的一个或多个项。使用双引号 (" ") 指定
                包含空格的路径。使用空格对各个项进行分隔。
                使用 * 添加当前目录的所有内容。

选项：

    -^R -^r --^recursive   以递归方式添加项。
    --^silent            不显示任何输出。
    --^ignorefailed      如果无法添加某一项，则添加操作将在没有
                        这一项的情况下继续进行。注意：如果无法添加
                        某个目录，则不会添加目录中的内容。
    --^skipcontentcheck  如果不足以根据扩展名将文件设置为
                        文本或二进制，则会将该文件设置为二进制，
                        而不是检查内容来检测类型。这样做
                        是为了在进行大量签入时提高性能。
    --^coparent          对要添加的项的父级进行签出。
    --^filetypes         要使用的 filetypes 文件。请查看以下链接以了解
                        更多信息：
                        http://blog.plasticscm.com/2008/03/custom-file-types.html
    --^noinfo            不打印进度信息。
    --^format            检索特定格式的输出消息。请查看
                        示例以了解更多信息。
    --^errorformat       检索特定格式的错误消息
                        （如果有）。请查看示例以了解更多信息。

== CMD_HELP_ADD ==
备注：

    添加项的要求：
    - 要添加的项的父目录必须已事先添加。

从 stdin 读取输入：

    '^add' 命令可从 stdin 读取路径。为此，请传递一个破折号
    "-"。
    示例：cm ^add -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要添加的文件。
    示例：
      dir /S /B *.c | cm ^add -
      （在 Windows 中，添加工作区中的所有 .c 文件。）



示例：

    cm ^add file1.txt file2.txt
    （添加 'file1.txt' 和 'file2.txt' 项。）

    cm ^add c:\workspace\file.txt
    （添加路径 'c:\workspace' 中的 'file.txt' 项。）

    cm ^add -^R c:\workspace\src
    （以递归方式添加 'src'。）

    cm ^add -^R *
    （以递归方式添加当前目录的所有内容。）

    cm ^add -^R * --^filetypes=filetypes.conf
    （以递归方式添加当前目录的所有内容，使用
    'filetypes.conf' 根据文件的扩展名为文件分配类型，
    而不是检查文件内容。）

    cm ^add --^coparent c:\workspace\dir\file.txt
    （将 'file.txt' 添加到源代码管理中，并执行 'dir' 的签出。）

    cm ^add -^R * --^format="ADD {0}" --^errorformat="ERR {0}"
    （以递归方式添加当前目录的所有内容，
    对于成功添加的文件，打印 '^ADD <项>'，而对于无法添加的项，
    则打印 '^ERR <项>'。）

== CMD_USAGE_ADDIGNOREPATTERN ==
用法：

      cm ^addignorepattern <模式>[ ...]
                          [--^workspace=<工作区路径> | --^allworkspaces] [--^remove]

== CMD_DESCRIPTION_ADMIN ==
在服务器上执行管理命令。

== CMD_USAGE_ADMIN ==
用法：

    cm ^admin <命令> [选项]

可用命令：

    ^readonly

    要获取有关每条命令的更多信息，请运行：
    cm ^admin <命令> --^usage
    cm ^admin <命令> --^help

== CMD_HELP_ADMIN ==
备注：
    只有服务器管理员才能执行管理命令。

示例：

    cm ^admin ^readonly ^enter
    cm ^admin ^readonly ^status

== CMD_DESCRIPTION_ADMIN_READONLY ==
启用/禁用服务器只读模式。

== CMD_USAGE_ADMIN_READONLY ==
用法：

    cm ^admin ^readonly (^enter | ^leave | ^status) [<服务器>]

操作：

    ^enter   服务器进入只读模式。写操作将被拒绝。
    ^leave   服务器退出只读模式。
    ^status  显示服务器只读模式状态。

选项：
    服务器  在指定服务器（服务器:端口）中执行命令。（使用
            'cm ^help ^objectspec' 可进一步了解服务器规格。）
            如果未指定服务器，则该命令适用于当前工作区的
            服务器。
            如果当前路径不在工作区中，则该命令适用于
            client.conf 配置文件中定义的默认服务器。

== CMD_HELP_ADMIN_READONLY ==
备注：
    只有服务器管理员才能进入服务器只读模式。

示例：

    cm ^admin ^readonly ^enter diana:8086
    cm ^admin ^readonly ^leave

== CMD_DESCRIPTION_ANNOTATE ==
显示文件每一行上次修改所在的变更集及其作者。

== CMD_USAGE_ANNOTATE ==
用法：

    cm ^annotate | ^blame <规格>[ ...]
        [--^format=<格式字符串>]
        [--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
        [--^dateformat=<日期格式字符串>]
        [--^encoding=<名称>]
        [--^stats]
        [--^repository=<存储库规格>]

    规格        要批注的文件的规格。
                （使用 'cm ^help ^objectspec' 可进一步了解规格。）
                使用双引号 (" ") 指定包含空格的路径。

选项：

    --^format        检索特定格式的输出消息。请参阅
                    “备注”以了解更多信息。
    --^ignore        设置指定的比较方法。
                    请参阅“备注”以了解更多信息。
    --^dateformat    设置输出格式以打印日期。
    --^encoding      指定输出编码，如：utf-8。
                    请参阅位于以下网址的 MSDN 文档：
                    http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                    以查看包含受支持编码及其格式的表格
                    （位于页面末尾的“名称”列中）。
    --^stats         显示统计信息。
    --^repository    指定用于计算批注的存储库
                    规格。默认情况下，此命令使用的
                    存储库存储了工作区中已加载的
                    修订存储库。（使用 'cm ^help ^objectspec' 可进一步
                    了解存储库规格。）

== CMD_HELP_ANNOTATE ==
备注：

    无法批注二进制文件。

    --^ignore 选项：
        ^none                检测行尾和空格差异。
        ^eol                 忽略行尾差异。
        ^whitespaces         忽略空格差异。
        ^"eol&whitespaces"   忽略行尾和空格差异。

    --^format 选项：
        此命令的输出参数如下：
        {^owner}        上次更改行的用户。
        {^rev}          行的源修订规格。
        {^content}      行内容。
        {^date}         签入行的日期。
        {^comment}      行的源修订的注释。
        {^changeset}    行的源修订的变更集。
        {^line}         文件中的行号。
        {^id}           项 ID。
        {^parentid}     项的父级 ID。
        {^rep}          项的存储库。
        {^branch}       行的源修订的分支。
        {^ismergerev}   是否在合并中创建了行的修订。

    --^dateformat:
        指定打印日期的输出格式。
        请参阅以下网址中指明的受支持格式：
        https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings

    --^repository:
        从远程存储库检索数据。适合用于分布式
        场景。

示例：

    cm ^blame c:\workspace\src --^ignore=^"eol&whitespaces" --^encoding=utf-8
    cm ^annotate c:\workspace\file.txt --^ignore=^eol

    cm ^annotate c:\workspace\file.txt --^format="{^owner} {^date, 10} {^content}"
    （依次写入 owner 字段、一个空格、date 字段（右对齐）、
    一个空格以及 content 字段。）

    cm ^blame c:\workspace\file.txt --^format="{^owner, -7} {^comment} {^date}" \
        --^dateformat=yyyyMMdd
    （依次写入 owner 字段（占用 7 个空格，左对齐）、
    一个空格、comment 字段、另一个空格以及结尾的
    格式化日期（例如，20170329）。）

    cm ^annotate c:\workspace\file.txt --^repository=centralRep@myserver:8084

    cm ^blame ^serverpath:/src/client/checkin/Checkin.cs#^cs:73666
    （使用服务器路径对变更集 73666 中开始的文件进行批注。）

== CMD_DESCRIPTION_APPLY_LOCAL ==
检查是否有本地更改（本地移动、本地删除和本地更改）
并应用这些更改，以便 Plastic SCM 开始跟踪这些更改。

== CMD_USAGE_APPLY_LOCAL ==
用法：

    cm ^applylocal | ^al [--^dependencies] [<项路径>[ ...]]
                    [--^machinereadable [--^startlineseparator=<分隔符>]
                      [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

选项：

    --^dependencies        将本地更改依赖项添加到要应用
                          的项。
    项路径             要应用的项。使用空格对各个路径进行
                          分隔。使用双引号 (" ") 指定包含空格
                          的路径。
    --^machinereadable     以易于解析的格式输出结果。
    --^startlineseparator  与 '--^machinereadable' 标志结合使用，指定
                          行应如何开头。
    --^endlineseparator    与 '--^machinereadable' 标志结合使用，指定
                          行应如何结尾。
    --^fieldseparator      与 '--^machinereadable' 标志结合使用，指定
                          应如何分隔字段。

== CMD_HELP_APPLY_LOCAL ==
备注：

    如果未指定 --^dependencies 和 <项路径>，则该操作涉及
    工作区中的所有本地更改。
    始终以递归方式从给定路径应用。

示例：

    cm ^applylocal foo.c bar.c

    cm ^applylocal .
    （应用当前目录中的所有本地更改。）

    cm ^applylocal
    （应用工作区中的所有本地更改。）

    cm ^applylocal --^machinereadable
    （应用工作区中的所有本地更改，并以易于解析的
    简化格式打印结果。）

    cm ^applylocal --^machinereadable --^startlineseparator=">" \
      --^endlineseparator="<" --^fieldseparator=","
    （应用工作区中的所有本地更改，并以易于解析的
    简化格式打印结果，以指定的字符串作为行的开头和结尾以及
    对各字段进行分隔。）

== CMD_DESCRIPTION_ARCHIVE ==
将数据存档在外部存储中。

== CMD_USAGE_ARCHIVE ==
用法：

    cm ^archive | ^arch <修订规格>[ ...][-^c | --^comment=<注释字符串>]
                        [--^file=<基项文件>]
    （从存储库中提取数据并将这些数据存储在外部存储中。）

    cm ^archive | ^arch <修订规格>[ ...]--^restore
    （将以前存档的修订还原到存储库中。）

    修订规格             一个或多个修订规格。可通过 "-" 修饰符从 STDIN
                        进行读取。（使用 'cm ^help ^objectspec' 可
                        进一步了解修订规格。）
    --^restore           从生成的存档文件中还原以前存档的
                        数据。

选项：

    -^c | --^comment      在要创建的存档存储文件中设置注释。
    --^file              新存档数据文件的名称前缀和
                        （可选）路径。

== CMD_HELP_ARCHIVE ==
备注：

    此命令从存储库数据库中提取数据并将这些数据存储在
    外部存储中，从而节省数据库空间。
    此命令还可以将以前存档的修订还原到
    存储库数据库中 (--^restore)。

    使用 'cm ^help ^objectspec' 可了解如何指定修订规格。

    运行此命令的用户必须是 Plastic SCM 服务器管理员
    （存储库服务器所有者）才能完成操作。

    来自指定修订中的每个数据段都将存储在
    不同的文件中，且文件名以 --^file
    参数定义的值开头。此参数可以包含完整路径值，其中包括
    未来存档文件的前缀，也可以仅包含此前缀值。

    存档后可以通过两种方式访问来自指定修订中的
    数据：

    - 从客户端：客户端将检测数据是否已存档，
      并提示用户输入文件的位置。
      用户可以通过创建一个名为 externaldata.conf 的
      文件（在标准配置文件位置，使用适用于
      client.conf 文件的相同规则）来配置外部数据位置，
      其中包含已存档数据所在的路径。

    - 从服务器：通过这种方式，用户将不必知道数据
      是否已存档，因为请求将以透明的方式由服务器
      解析。为此，管理员将在服务器目录中创建一个
      名为 externaldata.conf 的文件，并在该文件中填充
      已存档的卷所在的路径。

    要取消存档（还原）一个修订（或一组修订），必须能够
    从客户端访问已存档的文件。因此，无法取消存档
    服务器正在解析的数据（方法 2），原因是客户端
    无法将数据识别为已存档。如果使用了方法 2，
    为了成功取消存档，管理员必须首先编辑
    externaldata.conf 服务器文件，以便删除对必须取消存档的
    已存档文件的访问权限。

    设置 PLASTICEDITOR 环境变量可指定用于键入注释的
    编辑器。

示例：

    cm ^archive bigfile.zip#^br:/main
    （在分支 'main' 中存档 'bigfile.zip' 的最后一个修订。）

    cm ^archive ^rev:myfile.pdf#^cs:2 -^c="大型 PDF 文件" --^file=c:\arch_files\arch
    （将变更集 2 中 myfile.pdf 的修订存档在 'c:\archived_files'
    文件夹中。存档的文件名将以 'arch' 开头（例如 arch_11_56）。）

    cm ^find "^revs ^where ^size > 26214400" --^format="{^item}#{^branch}" \
      --^nototal | cm ^archive --^comment="volume00" --^file="volume00" -
    （将所有大于 25Mb 的文件存档在名称 'volume00' 开头的
    文件中。）

    cm ^find "^revs ^where ^size > 26214400 ^and ^archived='true'" \
      --^format="{^item}#{^branch}" --^nototal | cm ^archive --^restore
    （还原所有大于 25Mb 的存档文件。）

== CMD_DESCRIPTION_ATTRIBUTE ==
允许用户管理属性。

== CMD_USAGE_ATTRIBUTE ==
用法：

    cm ^attribute | ^att <命令> [选项]

命令：

    ^create | ^mk
    ^delete | ^rm
    ^set
    ^unset
    ^rename
    ^edit

    要获取有关每条命令的更多信息，请运行：
    cm ^attribute <命令> --^usage
    cm ^attribute <命令> --^help

== CMD_HELP_ATTRIBUTE ==
示例：

    cm ^attribute ^create 状态
    cm ^attribute ^set ^att:status ^br:/main/SCM105 未完成
    cm ^attribute ^unset ^att:status ^br:/main/SCM105
    cm ^attribute ^delete ^att:status
    cm ^attribute ^rename ^att:status "构建状态"
    cm ^attribute ^edit ^att:status "CI 管道中任务的状态"

== CMD_DESCRIPTION_CHANGELIST ==
对更改列表中的待定更改进行分组。

== CMD_USAGE_CHANGELIST ==
用法：

    a) 管理更改列表对象：

       cm ^changelist | ^clist [--^symlink]
       （显示所有更改列表。）

       cm ^changelist | ^clist ^add <更改列表名称>
          [<更改列表描述>] [--^persistent | --^notpersistent] [--^symlink]
       （创建更改列表。）

       cm ^changelist | ^clist ^rm <更改列表名称> [--^symlink]
       （删除所选的更改列表。如果此更改列表包含待定更改，
       这些更改将移至 ^default 更改列表。）

       cm ^changelist | ^clist ^edit <更改列表名称> [<操作名称> <操作值>]
                             [--^persistent | --^notpersistent] [--^symlink]
       （编辑所选的更改列表。）

    b) 管理给定更改列表的内容：

       cm ^changelist | ^clist <更改列表名称> (^add | ^rm) <路径名称>[ ...]
                             [--^symlink]
       （通过添加 ('^add') 或删除 ('^rm') 与给定路径名称匹配的更改
       来添加所选的更改列表。使用空格
       对各个路径名称进行分隔。使用双引号 (" ") 指定包含空格的
       路径。路径的状态必须为 '^Added' 或 '^Checked-out'。）

选项：

    更改列表名称          更改列表的名称。
    更改列表描述          更改列表的描述。
    操作名称         选择 '^rename' 或 '^description' 来编辑
                        更改列表。
    操作值        在编辑更改列表时应用新名称或
                        新描述。
    --^persistent        即使更改列表的内容已被签入或还原，
                        更改列表也会保留在工作区中。
    --^notpersistent     （默认值）即使更改列表的内容已被签入
                        或还原，更改列表也不会保留在
                        工作区中。
    --^symlink           将操作应用于符号链接而不是
                        目标。

== CMD_HELP_CHANGELIST ==
备注：

    '^changelist' 命令会处理工作区待定更改列表以及更改列表中
    包含的更改。

示例：

    cm ^changelist
    （显示当前工作区更改列表。）

    cm ^changelist ^add 配置更改 "dotConf 文件" --^persistent
    （创建一个名为 '配置更改' 和描述为 'dotConf
    文件' 的新更改列表，该更改列表在待定更改列表被签入
    或还原后将在当前工作区中持久保留。）

    cm ^changelist ^edit 配置更改 ^rename 配置文件 --^notpersistent
    （编辑名为 '配置更改' 的更改列表，并将该更改列表重命名为
    '配置文件'。此外还会将更改列表变为“非持久性”。）
        
    cm ^changelist ^edit 配置更改 --^notpersistent
    （编辑名为 '配置更改' 的更改列表，并将该更改列表变为“非持久性”。）

    cm ^changelist ^rm 配置文件
    （从当前工作区中删除待定更改列表 '配置文件'。）

    cm ^changelist 配置文件 ^add foo.conf
    （将文件 'foo.conf' 添加到 '配置文件' 更改列表中。）

    cm ^changelist 配置文件 ^rm foo.conf readme.txt
    （从 '配置文件' 更改列表中删除文件 'foo.conf' 和 'readme.txt'，
    并将这些文件移至系统默认更改列表。）

== CMD_DESCRIPTION_CHANGESET ==
对变更集执行高级操作。

== CMD_USAGE_CHANGESET ==
用法：

    cm ^changeset <命令> [选项]

命令：

    ^move        | ^mv
    ^delete      | ^rm
    ^editcomment | ^edit

    要获取有关每条命令的更多信息，请运行：
    cm ^changeset <命令> --^usage
    cm ^changeset <命令> --^help

== CMD_HELP_CHANGESET ==
示例：

    cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
    cm ^changeset ^delete ^cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData

== CMD_DESCRIPTION_CHANGESET_EDIT_COMMENT ==
修改变更集的注释。

== CMD_USAGE_CHANGESET_EDIT_COMMENT ==
用法：

    cm ^changeset ^editcomment | ^edit <变更集规格> <新注释>

选项：

    变更集规格            要修改注释的目标变更集。
                        （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）
    新注释         要添加到目标变更集的
                        新注释。

== CMD_HELP_CHANGESET_EDIT_COMMENT ==
备注：

    - 目标变更集规格必须有效。

示例：

    cm ^changeset ^editcomment ^cs:15@myrepo "我忘了添加签入详细信息"
    cm ^changeset ^edit ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
         "此注释文本将替代先前的注释文本。"

== CMD_DESCRIPTION_CHANGESET_MOVE ==
将变更集及其所有后代移动到另一个分支。

== CMD_USAGE_CHANGESET_MOVE ==
用法：

    cm ^changeset ^move | ^mv <变更集规格> <分支规格>

选项：

    变更集规格            要移动到另一个分支的第一个变更集。All
                        同一分支中的所有后代变更集也将作为
                        该命令的目标。
                        （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）
    分支规格          存储目标变更集的目标
                        分支。目标分支需要为空或不存在；
                        如果目标分支不存在，该命令将创建
                        目标分支。
                        （使用 'cm ^help ^objectspec' 可进一步了解分支
                        规格。）

== CMD_HELP_CHANGESET_MOVE ==
备注：

    - 目标变更集规格必须有效。
    - 目标分支必须为空或不存在。
    - 如果目标分支不存在，则会创建目标分支。
    - 合并链接将保持不变，因为分支不会影响它们。

示例：

    cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
    cm ^changeset ^move ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a ^br:/hotfix/TL-352

== CMD_DESCRIPTION_CHANGESET_DELETE ==
从存储库中删除变更集。

== CMD_USAGE_CHANGESET_DELETE ==
用法：

    cm ^changeset ^delete | ^rm <变更集规格>

选项：

    变更集规格           要删除的目标变更集。必须满足
                       某些特定条件。请参阅“备注”以了解更多信息。
                       （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）

== CMD_HELP_CHANGESET_DELETE ==
备注：

    - 目标变更集必须是其分支中的最后一个变更集。
    - 目标变更集不能是任何其他变更集的父级。
    - 目标变更集既不能作为合并链接的源，也不能
      在间隔合并中作为源。
    - 不得将任何标签应用于目标变更集。
    - 目标变更集不能是根变更集 ('^cs:0')

示例：

    cm ^changeset ^rm ^cs:4525@myrepo@myserver
    cm ^changeset ^delete ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a

== CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
更改用户密码 (UP)。

== CMD_USAGE_CHANGEUSERPASSWORD ==
用法：

    cm ^changepassword | ^passwd

== CMD_HELP_CHANGEUSERPASSWORD ==
备注：

    仅当安全性配置为 UP（用户/密码）时，
    此命令才可用。请参阅《管理指南》以了解更多信息。
    需要新旧密码。

示例：

    cm ^passwd

== CMD_DESCRIPTION_CHECKCONNECTION ==
检查与服务器的连接。

== CMD_USAGE_CHECKCONNECTION ==
用法：

      cm ^checkconnection | ^cc

== CMD_HELP_CHECKCONNECTION ==
备注：

    - 此命令返回一条消息，指示是否存在与配置的
      Plastic SCM 服务器之间的有效连接。
    - 此命令检查配置的用户是否有效。此外
      还会检查与服务器的版本兼容性。

== CMD_DESCRIPTION_CHECKDB ==
检查存储库的完整性。

== CMD_USAGE_CHECKDB ==
用法：

    cm ^checkdatabase | ^chkdb [<存储库服务器规格> | <存储库规格>]

使用 'cm ^help ^objectspec' 可进一步了解存储库服务器和存储库规格。

== CMD_HELP_CHECKDB ==
备注：

    - 如果未指定存储库服务器规格和存储库规格，
      则将在 client.conf 文件内指定的服务器中执行检查。

示例：

    cm ^checkdatabase ^repserver:localhost:8084
    cm ^chkdb ^rep:default@localhost:8084

== CMD_DESCRIPTION_CHECKIN ==
将更改存储在存储库中。

== CMD_USAGE_CHECKIN ==
用法：

    cm ^checkin | ^ci [<项路径>[ ...]]
        [-^c=<注释字符串> | -^commentsfile=<注释文件>]
        [--^all|-^a] [--^applychanged] [--^private] [--^update] [--^symlink]
        [--^noshowchangeset]
        [--^machinereadable [--^startlineseparator=<分隔符>]
          [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

选项：

    项路径             要签入的项。使用双引号 (" ")
                          指定包含空格的路径。使用空格
                          对各个项路径进行分隔。
                          使用 . 将签入应用到当前目录。
    -^c                    将指定的注释应用于在签入操作中创建的
                          变更集。
    -^commentsfile         将指定文件中的注释应用于在签入操作中
                          创建的变更集。
    --^all | -^a            还包括在给定路径上进行了本地更改、移动
                          和删除的项。
    --^applychanged        将签入操作应用于在工作区中
                          检测到的已更改项以及
                          签出的项。
    --^private             还包括在工作区中检测到的
                          私有项。
    --^update              自动处理更新合并
                          （如果最终发生此行为）。
    --^symlink             将签入操作应用于符号链接而不是
                          目标。
    --^noshowchangeset     不打印结果变更集。
    --^machinereadable     以易于解析的格式输出结果。
    --^startlineseparator  与 '--^machinereadable' 标志结合使用，指定
                          行应如何开头。
    --^endlineseparator    与 '--^machinereadable' 标志结合使用，指定
                          行应如何结尾。
    --^fieldseparator      与 '--^machinereadable' 标志结合使用，指定
                          应如何分隔字段。

== CMD_HELP_CHECKIN ==
备注：

    - 如果未指定 <项路径>，则签入操作涉及
      工作区中的所有待定更改。
    - 签入操作始终以递归方式从给定路径应用。
    - 要签入项，必须满足以下条件：
      - 项必须受源代码管理。
      - 如果是私有项（不受源代码管理），则必须有 --^private
        标志才能签入该项。
      - 必须签出项。
      - 如果已更改但未签出项，则除非 <项路径> 是目录
        或包含通配符 ('*')，否则不需要
        --^applychanged 标志。

    修订内容必须与以前的修订不同才能
    签入。

    设置 PLASTICEDITOR 环境变量可指定用于键入注释的
    编辑器。

从 stdin 读取输入：

    '^checkin' 命令可从 stdin 读取路径。为此，请传递一个
    破折号 "-"。
    示例：cm ^checkin -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要签入的文件。
    示例：
      dir /S /B *.c | cm ^checkin --^all -
      （在 Windows 中，签入工作区中的所有 .c 文件。）

示例：

    cm ^checkin file1.txt file2.txt
    （签入已签出的文件 'file1.txt' 和 'file2.txt'。）

    cm ^checkin .-^commentsfile=mycomment.txt
    （签入当前目录并在 'mycomment.txt' 文件中
    设置注释。）

    cm ^checkin 链接 --^symlink
    （签入 '链接' 文件而不是目标；适用于 UNIX
    环境。）

    cm ^ci file1.txt -^c="我的注释"
    （签入 'file1.txt' 并包含注释。）

    cm ^status --^short --^compact --^changelist=pending_to_review | cm ^checkin -
    （列出名为 'pending_to_review' 的更改列表中的路径，并将此列表
    重定向到 checkin 命令的输入。）

    cm ^ci .--^machinereadable
    （签入当前目录，并以易于解析的简化格式
    打印结果。）

    cm ^ci .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" --^fieldseparator=","
    （签入当前目录，并以易于解析的简化格式
    打印结果，以指定的字符串作为行的开头和结尾以及
    对各字段进行分隔。）

== CMD_DESCRIPTION_CHECKOUT ==
将文件标记为修改就绪。

== CMD_USAGE_CHECKOUT ==
用法：

    cm ^checkout | ^co [<项路径>[ ...]] [-^R | -^r | --^recursive]
                     [--^format=<格式字符串>]
                     [--^errorformat=<格式字符串>] [--^resultformat=<格式字符串>]
                     [--^silent] [--^symlink] [--^ignorefailed]
                     [--^machinereadable [--^startlineseparator=<分隔符>]
                       [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

选项：

    项路径             要签出的项。使用双引号 (" ")
                          指定包含空格的路径。使用空格
                          对各个项路径进行分隔。
                          使用 . 将签出应用到当前目录。
    -^R                    以递归方式签出文件。
    --^format              检索特定格式的输出进度
                          消息。请查看示例以了解更多信息。
    --^errorformat         检索特定格式的错误消息
                          （如果有）。请查看示例以了解更多信息。
    --^resultformat        检索特定格式的输出结果
                          消息。请查看示例以了解更多信息。
    --^silent              不显示任何输出。
    --^symlink             将签出操作应用于符号链接而不是
                          目标。
    --^ignorefailed        如果无法锁定某项（无法执行独占签出），
                          则签出操作将在没有这一项的情况下
                          继续进行。
    --^machinereadable     以易于解析的格式输出结果。
    --^startlineseparator  与 '--^machinereadable' 标志结合使用，指定
                          行应如何开头。
    --^endlineseparator    与 '--^machinereadable' 标志结合使用，指定
                          行应如何结尾。
    --^fieldseparator      与 '--^machinereadable' 标志结合使用，指定
                          应如何分隔字段。

== CMD_HELP_CHECKOUT ==
备注：

    要签出项，必须满足以下条件：
    - 项必须受源代码管理。
    - 必须签入项。

    如果在服务器上配置了锁（存在 lock.conf），则每次
    在某条路径上进行签出时，Plastic 都会检查是否符合规则，
    如果符合，该路径将处于独占签出（锁定）状态，以便任何其他人
    都无法同时进行签出。
    可使用 'cm ^lock ^list' 获取服务器中的所有锁。
    请参阅《管理员指南》以了解更多信息：
    https://www.plasticscm.com/download/help/adminguide

    格式字符串将占位符 '{0}' 替换为要签出的
    项的路径。请查看示例以了解具体用法。

从 stdin 读取输入：

    '^checkout' 命令可从 stdin 读取路径。为此，请传递一个
    破折号 "-"。
    示例：cm ^checkout -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要签出的文件。
    示例：
      dir /S /B *.c | cm ^checkout -
      （在 Windows 中，签出工作区中的所有 .c 文件。）

示例：

    cm ^checkout file1.txt file2.txt
    （签出 'file1.txt' 和 'file2.txt' 文件。）

    cm ^co *.txt
    （签出所有文本文件。）

    cm ^checkout .
    （签出当前目录。）

    cm ^checkout -^R c:\workspace\src
    （以递归方式签出 'src' 文件夹。）

    cm ^co file.txt --^format="正在签出项 {0}"
        --^errorformat="签出项 {0} 时出错" /
        --^resultformat="项 {0} 已签出"
    （签出 'file.txt'，并使用指定的格式字符串
    显示操作的进度、结果和错误。）

    cm ^checkout 链接 --^symlink
    （签出 '链接' 文件而不是签出到目标；适用于 UNIX
    环境。）

    cm ^checkout .-^R --^ignorefailed
    （以递归方式签出当前文件夹，忽略无法签出的
    文件。）

    cm ^co .--^machinereadable --^startlineseparator=">"
    （签出当前目录，并以易于解析的简化格式打印结果，
    以指定的字符串作为行的开头。）

== CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
检查选择器的语法。

== CMD_USAGE_CHECKSELECTORSYNTAX ==
用法：

    cm ^checkselectorsyntax | ^css --^file=<选择器文件>
    （检查选择器文件语法。）

    ^cat <选择器文件> | cm ^checkselectorsyntax | ^css -
    （适用于 Unix。在标准输入中检查选择器文件。）

    ^type <选择器文件> | cm ^checkselectorsyntax | ^css -
    （适用于 Windows。在标准输入中检查选择器文件。）


    --^file     要从中读取选择器的文件。

== CMD_HELP_CHECKSELECTORSYNTAX ==
备注：

    此命令在文件或标准输入中读取选择器，并检查
    选择器是否为有效语法。如果语法检查结果为失败，则会将原因
    打印在标准输出中。

示例：

    cm ^checkselectorsyntax --^file=myselector.txt
    （检查 'myselector.txt' 文件的语法。）

    ^cat myselector.txt | cm ^checkselectorsyntax
    （在标准输入中检查 'myselector.txt' 的语法。）

== CMD_DESCRIPTION_CHGREVTYPE ==
更改某个项的修订类型（二进制或文本）。

== CMD_USAGE_CHGREVTYPE ==
用法：

    cm ^changerevisiontype | ^chgrevtype | ^crt <项路径>[ ...]--^type=(^bin | ^txt)

    项路径           要更改修订类型的项。使用双引号 (" ")
                        指定包含空格的路径。使用空格
                        对各个项路径进行分隔。
    --^type              目标修订类型。选择 '^bin' 或 '^txt'。

== CMD_HELP_CHGREVTYPE ==
备注：

    此命令只能应用于文件，而不能应用于目录。
    指定的类型必须是系统支持的类型：'^bin' 或 '^txt'（二进制
    或文本）。

示例：

    cm ^changerevisiontype c:\workspace\file.txt --^type=^txt
    （将 'file.txt' 修订类型更改为文本。）

    cm ^chgrevtype comp.zip "image file.jpg" --^type=^bin
    （将 'comp.zip' 和 "image file.jpg" 修订类型更改为二进制。）

    cm ^crt *.* --^type=^txt
    （将所有文件的修订类型更改为文本。）

== CMD_DESCRIPTION_TRIGGER_EDIT ==
编辑触发器。

== CMD_USAGE_TRIGGER_EDIT ==
用法：

    cm ^trigger | ^tr ^edit <子类型_类型> <位置编号>
                         [--^position=<新位置>]
                         [--^name=<新名称>] [--^script=<脚本路径>]
                         [--^filter=<筛选器字符串>] [--^server=<存储库服务器规格>]

    子类型_类型        触发器执行和触发器操作。
                        键入 'cm ^showtriggertypes' 可查看触发器类型
                        列表。
    位置编号     要修改的触发器占用位置。

选项：

    --^position          指定触发器的新位置。
                        此位置不能正在由相同类型的另一个
                        触发器使用。
    --^name              指定触发器的新名称。
    --^script            指定触发器脚本的新执行路径。
                        如果脚本以 "^webtrigger " 开头，则认为
                        这是 Web 触发器。请参阅“备注”以了解
                        更多详细信息。
    --^filter            仅检查与指定筛选条件匹配的项。
    --^server            修改指定服务器上的触发器。
                        如果未指定服务器，则在客户端上配置的
                        服务器上执行命令。
                        （使用 'cm ^help ^objectspec' 可进一步了解服务器
                        规格。）

== CMD_HELP_TRIGGER_EDIT ==
备注：

    Web 触发器：创建 Web 触发器的方法是键入 "^webtrigger <目标-URI>"
    作为触发器命令。在这种情况下，触发器将针对指定的 URI
    执行 POST 查询，其中，请求主体包含带有触发器
    环境变量的 JSON 字典，还有一个指向字符串数组的
    固定 INPUT 键。

示例：

    cm ^trigger ^edit ^after-setselector 6 --^name="Backup2 管理器" --^script="/new/path/al/script"
    cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
    cm ^trigger ^edit ^after-add 2 --^script="^webtrigger http://myserver.org/api"

== CMD_DESCRIPTION_CODEREVIEW ==
创建、编辑或删除代码审查。

== CMD_USAGE_CODEREVIEW ==
用法：

    cm ^codereview <规格> <标题> [--^status=<状态名称>]
                [--^assignee=<用户名>] [--^format=<格式字符串>]
                [--^repository=<存储库规格>]
    （创建代码审查。）

    cm ^codereview -^e <ID> [--^status=<状态名称>] [--^assignee=<用户名>]
                [--^repository=<存储库规格>]
    （编辑代码审查。）

    cm ^codereview -^d <ID> [ ...][--^repository=<存储库规格>]
    （删除一个或多个代码审查。）


    规格                可以是变更集规格或分支规格。此规格
                        将作为新代码审查的目标。（使用 
                        'cm ^help ^objectspec' 可进一步了解变更集规格
                        或分支规格。）
    标题               用作新代码审查的标题的
                        文本字符串。
    ID                  代码审查标识号。也可以使用
                        GUID。

选项：

    -^e                  编辑现有代码审查的参数。
    -^d                  删除一个或多个现有代码审查。使用
                        空格对各个代码审查 ID 进行分隔。
    --^status            设置代码审查的新状态。请参阅“备注”
                        以了解更多信息。
    --^assignee          设置代码审查的新被分派人。
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^repository        设置要用作默认存储库的存储库。（使用
                        'cm ^help ^objectspec' 可进一步了解存储库
                        规格。）

== CMD_HELP_CODEREVIEW ==
备注：

    此命令允许用户管理代码审查：为变更集或分支
    创建、编辑和删除代码审查。

    要创建新的代码审查，必须提供变更集/分支规格和
    标题。也可以设置初始状态和被分派人。结果将返回
    一个 ID（如果请求返回 GUID，则返回 GUID）。

    要编辑或删除现有代码审查，必须提供目标代码
    审查 ID（或 GUID）。如果没有错误，则不会显示任何消息。

    状态参数只能是以下值之一：^"Under review"
    （默认值）、^"Reviewed" 或 ^"Rework required"。

    repository 参数可用于设置默认的工作
    存储库。当用户想要在其他服务器上而不是在与当前工作区
    关联的服务器上管理审查时，或者根本没有
    当前工作区时，此参数很有用。

    输出格式自定义：

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0}             ID
        {1}             GUID

    请注意，'--^format' 参数仅在创建新的代码
    审查时生效。

示例：

    cm ^codereview ^cs:1856@myrepo@myserver:8084 "我的代码审查" --^assignee=dummy
    cm ^codereview ^br:/main/task001@myrepo@myserver:8084 "我的代码审查" \
    --^status=^"Rework required" --^assignee=newbie --^format="{^id} -> {^guid}"

    cm ^codereview 1367 -^e --^assignee=新的被分派人
    cm ^codereview -^e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --^status=已审查

    cm ^codereview -^d 1367 --^repository=myremoterepo@myremoteserver:18084
    cm ^codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -^d

== CMD_DESCRIPTION_CRYPT ==
对密码进行加密。

== CMD_USAGE_CRYPT ==
用法：

    cm ^crypt <我的密码>

    我的密码          要加密的密码。

== CMD_HELP_CRYPT ==
备注：

    此命令用于加密作为参数传递的给定密码。
    旨在对配置文件中的密码进行加密并提高
    安全性。

示例：

    cm ^crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
    （对数据库配置文件 'db.conf' 中的密码进行加密。）

== CMD_DESCRIPTION_DEACTIVATEUSER ==
停用许可的用户。

== CMD_USAGE_DEACTIVATEUSER ==
用法：

    cm ^deactivateuser | ^du <用户名>[ ...][--^server=<名称:端口>]
                           [--^nosolveuser]

    用户名            要停用的一个或多个用户名。使用空格
                        对各个用户名进行分隔。
                        如果是 SID，则需要 '--^nosolveuser'。

选项：

    --^server            停用指定服务器上的用户。
                        如果未指定服务器，则在客户端上配置的
                        服务器上执行命令。
    --^nosolveuser       使用此选项时，该命令将不会检查身份验证系统上
                        是否存在相应的用户名。而且
                        <用户名> 必须是用户 SID。

== CMD_HELP_DEACTIVATEUSER ==
备注：

    此命令将用户设置为非活动状态，从而禁止该用户使用
    Plastic SCM。

    有关激活 Plastic SCM 用户的更多信息，请参阅 'cm ^activateuser'
    命令。

    此命令检查用户是否在基础身份验证系统（例如 ActiveDirectory、
    LDAP、用户/密码...）上存在。
    要强制停用在身份验证系统上不再存在的
    用户，可以使用 '--^nosolveuser' 选项。

示例：

    cm ^deactivateuser john
    cm ^du peter "mary collins"
    cm ^deactivateuser john --^server=myserver:8084
    cm ^deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --^nosolveuser

== CMD_DESCRIPTION_DIFF ==
显示文件、变更集和标签之间的差异。

== CMD_USAGE_DIFF ==
用法：

    cm ^diff <变更集规格> | <标签规格> | <搁置规格> [<变更集规格> | <标签规格> | <搁置规格>]
            [<路径>]
            [--^added] [--^changed] [--^moved] [--^deleted]
            [--^repositorypaths] [--^download=<下载路径>]
            [--^encoding=<名称>]
            [--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
            [--^clean]
            [--^format=<格式字符串>] [--^dateformat=<格式字符串>]

        显示“源”变更集或搁置集与“目标”变更集或搁置集
        之间的差异。可使用变更集或标签规格
        来指定变更集。
        如果给出了两个规格，则第一个是差异比较的“源”，
        第二个是“目标”。
        如果仅给出一个规格，则“源”将是指定“目标”的
        父变更集。
        如果指定了可选路径，则将启动“差异比较窗口”以显示
        该文件的两个修订之间的差异。

    cm ^diff <修订规格1> <修订规格2>

        显示一对修订之间的差异。这些差异
        显示在“差异比较窗口”中。指定的第一个修订将
        显示在左侧。

    cm ^diff <分支规格> [--^added] [--^changed] [--^moved] [--^deleted]
            [--^repositorypaths] [--^download=<下载路径>]
            [--^encoding=<名称>]
            [--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
            [--^clean]
            [--^format=<格式字符串>] [--^dateformat=<格式字符串>]
            [--^fullpaths | --^fp]

        显示分支差异。

    （使用 'cm ^help ^objectspec' 可进一步了解规格。）

选项：

    --^added             仅打印包含已添加到存储库的项
                        的差异。
    --^changed           仅打印包含已更改的项
                        的差异。
    --^moved             仅打印包含已移动或已重命名的项
                        的差异。
    --^deleted           仅打印包含已删除的项
                        的差异。

                        如果未指定 '--^added'、'--^changed'、'--^moved' 或 '--^deleted'，
                        则该命令将打印所有差异。
                            '^A' 表示已添加的项。
                            '^C' 表示已更改的项。
                            '^D' 表示已删除的项。
                            '^M' 表示已移动的项。左侧的项是原始项，
                              右侧是目标项。

    --^repositorypaths   打印存储库路径而不是工作区路径。
                        （此选项将覆盖 '--^fullpaths' 选项。）
    --^download          将差异内容存储在指定的输出
                        路径中。
    --^encoding          指定输出编码，如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。
    --^ignore            设置指定的比较方法。
                        请参阅“备注”以了解更多信息。
    --^clean             不考虑由于合并而产生的
                        差异，仅考虑简单签入所创建的
                        差异。
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^dateformat        用于输出日期的格式。
    --^fullpaths, --^fp   如果可能，强制打印文件和目录的完整
                        工作区路径。

== CMD_HELP_DIFF ==
备注：

    比较方法：
        ^eol                 忽略行尾差异。
        ^whitespaces         忽略空格差异。
        ^"eol&whitespaces"   忽略行尾和空格差异。
        ^none                检测行尾和空格差异。

    此命令接受格式字符串以显示输出。
    此命令的参数如下：
        {^path}              项路径。
        {^date}              更改日期/时间。
        {^owner}             更改作者。
        {^revid}             在差异比较中被视为目标的修订的
                            修订 ID。
        {^parentrevid}       在差异比较中被视为目标的修订的
                            父级修订 ID。
        {^baserevid}         在差异比较中被视为源的修订的
                            修订 ID。
        {^srccmpath}         移动项（移动操作）之前的服务器路径。
        {^dstcmpath}         移动项（移动操作）之后的服务器路径。
        {^type}              项类型：
            ^D   目录，
            ^B   二进制文件，
            ^F   文本文件，
            ^S   符号链接，
            ^X   Xlink。
        {^repository}        项的存储库。
        {^status}            项状态：
            ^A   已添加，
            ^D   已删除，
            ^M   已移动，
            ^C   已更改。
        {^fsprotection}      显示项权限 (Linux/Mac chmod)。
        {^srcfsprotection}   显示父修订项权限。
        {^newline}           插入一个新行。

有关 '^revid' 的注意事项：
    对于已添加的项，'^baserevid' 和 '^parentrevid' 将为 -1，因为
    在这种情况下不存在以前的修订。
    对于已删除的项，'^revid' 是源修订的 ID，而
    '^baserevid' 将为 -1，因为没有目标修订。
    对于 Xlink，'^baserevid' 和 '^parentrevid' 都始终为 -1。

示例：

  比较分支：

    cm ^diff ^br:/main/task001
    cm ^diff ^br:/main/task001 \doc\readme.txt

  比较变更集树：

    cm ^diff 19
    cm ^diff 19 25
    cm ^diff ^cs:19 ^cs:25 --^format="{^path} {^parentrevid}"
    cm ^diff ^cs:19 ^cs:23 --^format="{^date} {^path}" --^dateformat="yy/dd/MM HH:mm:ss"
    cm ^diff ^cs:19 ^cs:23 --^changed
    cm ^diff ^cs:19 ^cs:23 --^repositorypaths
    cm ^diff ^cs:19 ^cs:23 --^download="D:\temp"
    cm ^diff ^cs:19 ^cs:23 --^clean
    cm ^diff ^cs:19 ^cs:23 \doc\readme.txt

  比较标签树：

    cm ^diff ^lb:FirstReleaseLabel ^lb:SecondReleaseLabel
    cm ^diff ^lb:tag_193.2 ^cs:34214
    cm ^diff ^cs:31492 ^lb:tag_193.2

  比较搁置树：

    cm ^diff ^sh:2
    cm ^diff ^sh:2 ^sh:4

  比较修订规格：
    cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
    cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
        ^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084

== CMD_DESCRIPTION_DIFFMETRICS ==
显示两个修订之间的差异比较指标。

== CMD_USAGE_DIFFMETRICS ==
用法：

    cm ^diffmetrics | ^dm <修订规格 1> <修订规格 2> [--^format=<格式字符串>]
                        [--^encoding=<名称>]
                        [--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]

    修订规格           用于比较的修订。
                      （使用 'cm ^help ^objectspec' 可进一步了解修订规格。）

选项：

    --^format          检索特定格式的输出消息。请参阅
                      “备注”以了解更多信息。
    --^encoding        指定输出编码，如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。
    --^ignore          设置指定的比较方法。
                      请参阅“备注”以了解更多信息。

== CMD_HELP_DIFFMETRICS ==
备注：

    指标为：已更改、添加和删除的行数。

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0}             已更改的行数。
        {1}             已添加的行数。
        {2}             已删除的行数。

示例：

    cm ^diffmetrics file.txt#^cs:2 file.txt#^br:/main/scm0211 \
    --^format="已更改 {0} 行，已添加 {1} 行，已删除 {2} 行。"
    （检索已格式化的差异比较指标结果。）

    cm ^dm file.txt#^cs:2 file.txt#^cs:3 --^encoding=utf-8 --^ignore=^whitespaces

== CMD_DESCRIPTION_FASTEXPORT ==
以快速导出格式导出存储库。

== CMD_USAGE_FASTEXPORT ==
用法：

    cm ^fast-export | ^fe <存储库规格> <快速导出文件>
                        [--^import-marks=<标记文件>]
                        [--^export-marks=<标记文件>]
                        [--^branchseparator=<分隔符>]
                        [--^nodata] [--^from=<变更集ID>] [--^to=<变更集ID>]

选项：

    存储库规格             要从中导出数据的存储库。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库规格。）
    快速导出文件    具有存储库数据并采用 Git 快速导出格式的
                        文件。
    --^import-marks      用于增量导入的标记文件。此文件
                        已在先前由 '--^export-marks' 导出。此
                        文件中描述的变更集将不会被导入，
                        因为这些变更集已在先前被导入。
    --^export-marks      所导入的变更集将保存到的文件。
                        此文件在以后的快速导入中用于表示
                        已导入的变更集。
    --^branchseparator   Plastic SCM 使用 "/" 作为分支层次结构中的默认
                        分隔符。此选项允许将字符用作层次结构
                        分隔符，因此 main-task-sub 将在 Plastic SCM 中
                        映射为 /main/task/sub。
    --^nodata            导出存储库，但不包括数据。这对于
                        检查导出功能是否可正确运行很有用。
    --^from              从特定变更集导出。
    --^to                导出到特定变更集。

== CMD_HELP_FASTEXPORT ==
备注：

    - 为了将 Plastic SCM 存储库导入到 Git，请使用诸如以下命令的命令：
      ^cat repo.fe.00 | ^git ^fast-import --^export-marks=marks.git  --^import-marks=marks.git

    - 支持使用一个包含先前导入的变更集的
      标记文件（'--^import-marks' 和 '--^export-marks' 文件）进行增量
      导出。
      这意味着将仅导出在先前快速导出中未导出的
      新变更集。

示例：

    cm ^fast-export repo@localhost:8087 repo.fe.00 --^import-marks=marks.cm \
      --^export-marks=marks.cm
    （将本地服务器中的存储库 'repo' 以 Git 快速导出格式
    导出到 'repo.fe.00' 文件中，并创建标记文件以稍后
    执行增量导出。）

    cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
    （将本地服务器中的存储库 'repo' 以 Git 快速导出格式
    从变更集 '20' 导出到 'repo.fe.00' 文件中。）

== CMD_DESCRIPTION_FASTIMPORT ==
将 Git 快速导出数据导入到存储库中。

== CMD_USAGE_FASTIMPORT ==
用法：

    cm ^fast-import | ^fi <存储库规格> <快速导出文件>
                        [--^import-marks=<标记文件>]
                        [--^export-marks=<标记文件>]
                        [--^stats] [--^branchseparator=<分隔符>]
                        [--^nodata] [--^ignoremissingchangesets] [--^mastertomain]

选项：

    存储库规格                     要将数据导入到的
                                存储库。如果事先不存在存储库，
                                则会创建该存储库。（使用 'cm ^help ^objectspec' 可进一步
                                了解存储库规格。）
    快速导出文件            具有存储库数据并采用 Git 快速
                                导出格式的文件。
    --^import-marks              用于增量导入的标记文件。
                                此文件已在先前由
                                '--^export-marks' 导出。此文件中描述的
                                变更集将不会被导入，因为这些变更集
                                已在先前被导入。
    --^export-marks              所导入的变更集将保存到的
                                文件。此文件在以后的
                                快速导入中用于表示
                                已导入的变更集。
    --^stats                     打印一些有关导入过程的统计信息。
    --^branchseparator           Plastic SCM 使用 "/" 作为分支层次结构
                                中的默认分隔符。此选项允许
                                将字符用作层次结构分隔符，因此 main-task-sub
                                将在 Plastic SCM 中映射为 /main/task/sub。
    --^nodata                    导入 Git 快速导出结果，但不包括
                                数据。这对于检查导入功能是否可正确
                                运行很有用。
    --^ignoremissingchangesets   无法导入的任何变更集都将被丢弃，
                                然后在没有这些变更集的情况下继续
                                进行快速导入操作。
    --^mastertomain              使用 "^main" 而不是 "^master" 进行导入。

== CMD_HELP_FASTIMPORT ==
备注：

    - 为了导出 Git 存储库，请使用诸如以下命令的命令：
      ^git ^fast-export --^all -^M --^signed-tags=^strip --^tag-of-filtered-object=^drop> ..\git-fast-export.dat
      -^M 选项对于检测移动的项很重要。

    - 如果指定的存储库不存在，则会创建该存储库。

    - 支持使用一个包含先前导入的变更集的
      标记文件（'--^import-marks' 和 '--^export-marks' 文件）进行增量
      导入。
      这意味着将仅导入在先前快速导入中未导入的
      新变更集。

示例：

    cm ^fast-import mynewrepo@atenea:8084  repo.fast-export
    （将导出到 'repo.fast-export' 文件中的内容导入到
    服务器 'atenea:8084' 上的 'mynewrepo' 存储库中。）

    cm ^fast-import repo@atenea:8084  repo.fast-export --^export-marks=rep.marks
    （将导出到 'repo.fast-export' 文件中的内容导入到
    服务器 'atenea:8084' 上的 'repo' 存储库中，并创建一个标记文件
    以稍后执行增量导入。）

    cm ^fast-import repo@server:8084  repo.fast-export --^import-marks=repo.marks \
      --^export-marks=repo.marks
    （导入 'repo.fast-export' 文件的内容。仅导入
    不在标记文件中的新变更集。同样的这个
    标记文件还用于再次保存变更集列表，以便进行
    下一次增量导入。）

== CMD_DESCRIPTION_FILEINFO ==
检索有关工作区中的项的详细信息。

== CMD_USAGE_FILEINFO ==
用法：

    cm ^fileinfo <项路径>[ ...][--^fields=<字段值>[,...]]
                [[--^xml | -^x [=<输出文件>]] | [--^format=<格式字符串>]]
                [--^symlink] [--^encoding=<名称>]

    项路径           要显示的项。使用空格对各个项进行
                        分隔。
                        使用双引号 (" ") 指定包含空格的
                        路径。

选项：

    --^fields            一串用逗号分隔的值。此字符串用于
                        选择要为每项打印的字段。请参阅“备注”
                        以了解更多信息。
    --^xml | -^x          以 XML 格式将输出打印到标准输出。
                        可以指定输出文件。此选项
                        不能与 '--^format' 结合使用。
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。此选项不能与 '--^xml'
                        结合使用。
                        此 '--^format' 选项优先于 '--^fields'（如果同时
                        指定了这两者）。
    --^symlink           将 fileinfo 操作应用于符号链接而不是
                        目标。
    --^encoding          指定输出编码，如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。


== CMD_HELP_FILEINFO ==
备注：

    此命令为每个所选项打印详细的属性列表。
    默认情况下，每个属性都打印在新行上。

    可以修改属性列表以仅显示用户所需的
    属性。为实现此目的，可以使用 '--^fields=<字段列表>'，
    其中会接受一串用逗号分隔的属性名称。这样就只会显示
    已指明名称的那些参数。

    修订头部变更集：

    默认情况下会禁用此选项。请注意，检索此属性的
    速度明显慢于其余属性，因此我们建议用户
    将尽可能多的项组合在一起。这样可以避免
    多次单独执行 'cm ^fileinfo'，从而缩短执行时间。
    另外，此功能当前不适用于受控目录。

    您可以在下面找到可用属性名称的完整列表。
    默认情况下不会显示标有星号 ('*') 的名称：
        ^ClientPath              项在磁盘上的本地路径。
        ^RelativePath            相对于工作区的路径。
        ^ServerPath              项的存储库路径。
                                （注意：此选项当前
                                不支持已变换的工作区）。
        ^Size                    项大小。
        ^Hash                    项哈希值总和。
        ^Owner                   项所属的用户。
        ^RevisionHeadChangeset   (*) 已加载到分支头部变更集内的
                                修订变更集。
                                （请参阅上面的注意事项。）
        ^RevisionChangeset       当前已加载到工作区内的
                                修订变更集。
        ^RepSpec                 项的存储库规格。
                                （使用 'cm ^help ^objectspec' 可进一步了解
                                存储库规格。）
        ^Status                  工作区项状态：已添加、已签出、
                                已删除，等等。
        ^Type                    修订类型（文本、二进制、目录、符号链接
                                或未知）。
        ^Changelist              项所属的更改列表（如果有）。
        ^IsLocked                (*) 项是否已被独占签出
                                锁定。
        ^LockedBy                (*) 将项独占签出的用户。
        ^LockedWhere             (*) 将项独占签出的
                                位置。
        ^IsUnderXlink            项是否位于 Xlink
                                之下。
        ^UnderXlinkTarget        项所在的 Xlink 的目标
                                （如果有）。
        ^UnderXlinkPath          通过 Xlink 链接的存储库中的项服务器路径
                                （如果有）。
        ^UnderXlinkWritable      项所属的 Xlink 是否
                                可写。
        ^UnderXlinkRelative      项所属的 Xlink 是否
                                是相对 Xlink。
        ^IsXlink                 项本身是否是 Xlink。
        ^XlinkTarget             项指向的目标存储库（如果项
                                是 Xlink）。
        ^XlinkName               项的 Xlink 名称（如果项实际上
                                是 Xlink）。
        ^XlinkWritable           Xlink 项是否为
                                可写 Xlink。
        ^XlinkRelative           Xlink 项是否为
                                相对 Xlink。

    输出格式自定义：

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {^ClientPath}
        {^RelativePath}
        {^ServerPath}
        {^Size}
        {^Hash}
        {^Owner}
        {^RevisionHeadChangeset}
        {^RevisionChangeset}
        {^Status}
        {^Type}
        {^Changelist}
        {^IsLocked}
        {^LockedBy}
        {^LockedWhere}
        {^IsUnderXlink}
        {^UnderXlinkTarget}
        {^UnderXlinkPath}
        {^UnderXlinkWritable}
        {^UnderXlinkRelative}
        {^IsXlink}
        {^XlinkTarget}
        {^XlinkName}
        {^XlinkWritable}
        {^XlinkRelative}
        {^RepSpec}

    请注意，'--^format' 和 '--^xml' 选项是互斥的，
    因此不能同时使用。

示例：

    cm ^fileinfo file1.txt file2.txt dir/
    cm ^fileinfo "New Project.csproj" --^xml
    cm ^fileinfo assets.art --^fields=^ServerPath,^Size,^IsLocked,^LockedBy
    cm ^fileinfo proj_specs.docx --^fields=^ServerPath,^RevisionChangeset --^xml
    cm ^fileinfo samples.ogg --^format="{^ServerPath}[{^Owner}] -> {^Size}"

== CMD_DESCRIPTION_FIND_QUERY ==
运行类似 SQL 的查询以查找 Plastic SCM 对象。

== CMD_USAGE_FIND_QUERY ==
用法：

    cm ^find <对象类型>
            [^where <条件字符串>]
            [^on ^repository '<存储库规格>' | ^on ^repositories '<存储库规格1>','<存储库规格2>'[,...]]
            [--^format=<格式字符串>] [--^dateformat=<日期格式>]
            [--^nototal] [--^file=<转储文件>] [--^xml]
            [--^encoding=<名称>]

    对象类型         要查找的对象类型。
                        （使用 'cm ^help ^showfindobjects' 可了解如何指定
                        这些对象。）
                        您还可以阅读 'cm ^find' 指南：
                        https://www.plasticscm.com/download/help/cmfind

选项：

    条件字符串      搜索对象属性的条件。
    存储库规格             搜索存储库别名或规格。
                        如果是 '^on ^repositories'，请使用逗号
                        对存储库规格字段进行分隔。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        规格。）
    --^format            检索特定格式的输出消息。
                        请阅读 'cm ^find' 指南以查看所有
                        可用作输出格式字符串的对象属性：
                        https://www.plasticscm.com/download/help/cmfind
    --^dateformat        用于输出日期的格式。
    --^nototal           最后不输出记录数。
    --^file              转储结果的文件。
    --^xml               以 XML 格式将输出打印到标准输出。
    --^encoding          指定输出编码，如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。

== CMD_HELP_FIND_QUERY ==
备注：

    如果未指定存储库，则在工作区中配置的存储库上
    进行搜索。

    从命令行中使用比较运算符（>、<、>=、<=）
    运行查询时，请注意，shell 将这些运算符视为 IO
    重定向。因此，需要用双引号将查询
    引起来。

    'cm ^find' 命令接受格式字符串以显示输出。
    每个输出参数由字符串进行标识，用户可以通过
    在 '{' 和 '}' 花括号之间键入参数编号来引用参数。
    输出参数通常对应于对象的属性。

    一些有效的输出格式字符串如下：
      --^format={^id}{^date}{^name}
      --^format="{^item}#{^branch} ^with ^date {^date}"

    XML 和编码注意事项：

    指定 '--^xml' 选项后，该命令在标准输出中将命令结果
    显示为 XML 文本。文本将以操作系统的
    默认编码显示，因此在控制台中可能会
    错误地显示非 ANSI 字符。如果将命令输出重定向到
    文件，则将正确显示输出内容。当同时指定了 '--^xml' 和 '--^file'
    选项时，默认编码为 utf-8。

示例：

    cm ^find ^revision
    cm ^find ^revision "^where ^changeset=23 ^and ^owner='maria'"
    cm ^find ^branch "^on ^repository 'rep1'"
    cm ^find ^label "^on ^repositories 'rep1', '^rep:default@localhost:8084'"
    cm ^find ^branch "^where ^parent='^br:/main' ^on ^repository 'rep1'"
    cm ^find ^revision "^where ^item='^item:.'" --^format="{^item}#{^branch}"
    cm ^find ^revision "^where ^item='^item:.'" --^xml --^file=c:\queryresults\revs.xml

== CMD_DESCRIPTION_FINDCHANGED ==
获取已更改文件的列表。已弃用此命令，保留此命令只是为了
向后兼容。请改用 'cm ^status'。

== CMD_USAGE_FINDCHANGED ==
用法：

    cm ^findchanged | ^fc [-^R | -^r | --^recursive] [--^checkcontent]
                        [--^onlychanged] [<路径>]

选项：

    -^R                  以递归方式在目录中查找。
    --^checkcontent      按内容比较文件。
    --^onlychanged       仅查找已更改的文件；无法获得
                        签出。
    路径                （默认值：当前目录。）
                        查找已更改文件的初始路径。

== CMD_HELP_FINDCHANGED ==
备注：

    如果未给出 '--^checkcontent' 选项，Plastic 将根据文件时间戳
    查找更改。当指定了 '--^checkcontent' 选项时，比较的是
    文件或文件夹内容，而不使用时间戳。

    与 Plastic SCM 服务器断开连接的情况下，此命令对于检测
    已更改的文件很有用。可以将输出通过管道传递到 checkout 命令，
    从而在稍后检查更改（请参阅示例）。

示例：

    cm ^findchanged .
    （在当前目录中查找已更改的文件。）

    cm ^findchanged -^R .| cm ^checkout -
    （签出已更改的元素。）

== CMD_DESCRIPTION_FINDCHECKEDOUT ==
获取已签出项的列表。已弃用此命令，保留此命令只是为了
向后兼容。请改用 'cm ^status'。

== CMD_USAGE_FINDCHECKEDOUT ==
用法：

    cm ^findcheckouts | ^fco [--^format=<格式字符串>] [--^basepath]

选项：

    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^basepath          开始搜索签出的起始路径。如果
                        未指定，则使用当前路径。

== CMD_HELP_FINDCHECKEDOUT ==
备注：

    此命令适合用于在一个步骤中签入项或撤销签出所有
    已签出的项，并将标准输出重定向到其他命令。
    请参阅示例。

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0}             日期。
        {1}             所有者。
        {2}             工作区信息。
        {3}             客户端机器名称。
        {4}             项路径。
        {5}             分支和存储库信息。

示例：

    cm ^findcheckouts --^format="分支 {5} 上已更改的文件 {4}"
    （查找已签出的项，并使用文件路径以及分支和存储库信息
    来格式化输出。）

    cm ^findcheckouts --^format={4} | cm ^checkin -
    （签入所有已签出的项。）

    cm ^findcheckouts --^format={4} | cm ^undocheckout -
    （撤销签出所有已签出的项。）

== CMD_DESCRIPTION_FINDPRIVATE ==
获取私有项的列表。已弃用此命令，保留此命令只是为了
向后兼容。请改用 'cm ^status'。

== CMD_USAGE_FINDPRIVATE ==
用法：
    cm ^findprivate | ^fp [-^R | -^r | --^recursive] [--^exclusions] [<路径>]

选项：

    -^R                  以递归方式在目录中查找。
    --^exclusions        此选项允许在文件 ignore.conf 定义的
                        已忽略路径内禁止搜索。
    路径                （默认值：当前目录。）
                        查找私有文件的初始路径。

== CMD_HELP_FINDPRIVATE ==
备注：

    如果指定了任何路径，Plastic SCM 将开始从当前目录
    搜索。

    此命令适合用于在文件夹上添加私有项，并将输出通过管道
    传递到 add 命令。请参阅示例。

示例：

    cm ^findprivate .

    cm ^findprivate -^R | cm ^add -
    （以递归方式搜索私有项并添加这些项。）

== CMD_DESCRIPTION_GETCONFIG ==
获取配置信息。

== CMD_USAGE_GETCONFIG ==
用法：

    cm ^getconfig [^setfileasreadonly] [^location] [^extensionworkingmode]
                 [^extensionprefix] [^defaultrepserver]
    
    ^setfileasreadonly       返回受保护文件是否保留为
                            只读。
    ^location                返回客户端配置路径。
    ^extensionworkingmode    返回扩展工作模式。
    ^extensionprefix         返回已配置的扩展前缀。
    ^defaultrepserver        返回默认存储库服务器的
                            位置。

== CMD_HELP_GETCONFIG ==
示例：

    cm ^getconfig ^setfileasreadonly

== CMD_DESCRIPTION_GETFILE ==
下载给定修订的内容。

== CMD_USAGE_GETFILE ==
用法：

    cm ^getfile | ^cat <修订规格> [--^file=<输出文件>] [--^debug]
                     [--^symlink] [--^raw]

    修订规格           对象规格。（使用 'cm ^help ^objectspec' 可
                      进一步了解规格。）

选项：

    --^file            用于保存输出的文件。默认情况下会打印在
                      标准输出中。
    --^debug           使用目录规格时，该命令
                      将显示目录中的所有项、目录的修订 ID
                      和文件系统保护。
    --^symlink         将操作应用于符号链接而不是
                      目标。
    --^raw             显示文件的原始数据。

== CMD_HELP_GETFILE ==
示例：

    cm ^cat myfile.txt#^br:/main
    （在 'myfile.txt' 的分支 '^br:/main' 中获取最后一个修订。）

    cm ^getfile myfile.txt#^cs:3 --^file=tmp.txt
    （获取 'myfile.txt' 的变更集 3 并将该变更集写入文件 'tmp.txt'。）

    cm ^cat ^serverpath:/src/foo.c#^br:/main/task003@myrepo
    （在存储库 'myrepo' 中的分支 '/main/task003' 的最后一个变更集处
    获取 '/src/foo.c' 的内容）

    cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
    （获得 ID 为 1230 的修订。）

    cm ^getfile ^rev:info\ --^debug
    （获取 'info' 目录中的所有修订。）

== CMD_DESCRIPTION_GETREVISION ==
在工作区中加载修订。

== CMD_USAGE_GETREVISION ==
此命令会修改工作区中加载的修订，因此可能影响
以后的合并。
这是从旧版本继承的高级命令，因此请谨慎使用。

用法：
    cm ^getrevision <修订规格>

    修订规格           对象规格。（使用 'cm ^help ^objectspec' 可
                      进一步了解修订规格。）

== CMD_HELP_GETREVISION ==
示例：

    cm ^getrevision file.txt#^cs:3
    （获取 'file.txt' 的变更集 3 修订。）

== CMD_DESCRIPTION_GETSTATUS ==
获取项的状态。

== CMD_USAGE_GETSTATUS ==
这是一个自动化命令，仅用于自动执行 'cm'。
此命令的用户友好度不如预期。

用法：

    cm ^getstatus | ^gs <项路径>[ ...][--^format=<格式字符串>] [--^stats]
                      [-^R | -^r | --^recursive]

    项路径           要获取相应状态的一个或多个项。使用双引号
                        (" ") 指定包含空格的路径。使用
                        空格对各个路径进行分隔。

选项：

    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^stats             打印一些有关获取状态过程的统计信息。
    -^R                  以递归方式显示目录中的状态。

== CMD_HELP_GETSTATUS ==
备注：

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0}             项路径。
        {1}             项状态：
            0   私有，
            1   已签入，
            2   已签出。

从 stdin 读取输入：

    '^getstatus' 命令可从 stdin 读取路径。为此，请传递
    一个破折号 "-"。
    示例：cm ^getstatus -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要获取哪些路径的状态。
    示例：
      dir /S /B *.c | cm ^getstatus --^format="路径 {0} 状态 {1}" -
      （在 Windows 中，获取工作区中所有 .c 文件的状态。）

示例：

    cm ^getstatus file1.txt file2.txt
    （获取文件的状态。）

    cm ^gs info\ -^R --^format="项 {0} 的状态为 {1}"
    （获取目录及其所有项的状态，并显示
    格式化的输出。）

== CMD_DESCRIPTION_GETTASKBRANCHES ==
获取与某个任务链接的分支。

== CMD_USAGE_GETTASKBRANCHES ==
这是一个自动化命令，仅用于自动执行 'cm'。
此命令的用户友好度不如预期。

用法：

    cm ^gettaskbranches | ^gtb <任务名称> [--^format=<格式字符串>]
                             [--^dateformat=<日期格式>]

    任务名称           任务标识符。

选项：

    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^dateformat        用于输出日期的格式。

== CMD_HELP_GETTASKBRANCHES ==
备注：

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {^tab}           插入一个制表符空格位。
        {^newline}       插入一个新行。
        {^name}          分支名称。
        {^owner}         分支的所有者。
        {^date}          创建分支的日期。
        {^type}          分支类型（如果是智能分支，则为 'T'，否则为 'F'）。
        {^parent}        父分支。
        {^comment}       分支的注释。
        {^repname}       分支所在的存储库。
        {^repserver}     服务器名称。

示例：

    cm ^gettaskbranches 4311
    cm ^gtb 4311 --^format="^br:{^name}"
    cm ^gtb 4311 --^format="^br:{^name} {^date}" --^dateformat="yyyy/MM/dd HH:mm:ss"

== CMD_DESCRIPTION_GETWWI ==
显示有关工作区选择器的信息。

== CMD_USAGE_GETWWI ==
用法：

    cm ^wi [<工作区路径>]

选项：

    工作区路径             工作区在机器上的路径。

== CMD_HELP_GETWWI ==
备注：
    '^wi' 命令显示工作区（存储库、分支和/或标签）
    的工作配置。

示例：
    cm ^wi c:\mywk

== CMD_DESCRIPTION_GWP ==
从路径获取工作区信息。

== CMD_USAGE_GWP ==
这是一个自动化命令，仅用于自动执行 'cm'。
此命令的用户友好度不如预期。

用法：

    cm ^getworkspacefrompath | ^gwp <项路径> [--^format=<格式字符串>]

    项路径           磁盘上的文件或文件夹。

选项：
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。

== CMD_HELP_GWP ==
备注：

    此命令显示有关路径中的工作区的信息。

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0} | {^wkname}          工作区名称。
        {1} | {^wkpath}          工作区路径。
        {2} | {^machine}         客户端机器名称。
        {3} | {^owner}           工作区所有者。
        {4} | {^guid}            工作区 GUID。

        {^tab}                   插入一个制表符空格位。
        {^newline}               插入一个新行。

示例：

    cm ^gwp c:\myworkspace\code\file1.cpp --^format="工作区名称：{^wkname}"

== CMD_DESCRIPTION_HELP ==
获取有关 Plastic SCM 命令的帮助。

== CMD_USAGE_HELP ==
用法：

    cm ^help <命令>

== CMD_HELP_HELP ==

== CMD_DESCRIPTION_IOSTATS ==
显示有关硬件的统计信息。

== CMD_USAGE_IOSTATS ==
用法：

    cm ^iostats [<存储库服务器规格>] [<测试列表>[ ...]]
               [--^nettotalmb=<值_mb>] [--^networkiterations=<值_迭代>]
               [--^diskdatasize=<值_大小>] [--^disktestpath=<值_路径>]
               [--^systemdisplaytime=<值_时间>]
               [--^systemdisplaytimeinterval=<值_间隔>]

选项：

    存储库服务器规格                 用于执行网络测试的可用 Plastic SCM
                                  服务器，例如 "serverUploadTest"
                                  和/或 "serverDownloadTest"。
                                  如果未提供服务器，该命令
                                  将尝试与默认配置的服务器
                                  通信。
                                  （使用 'cm ^help ^objectspec' 可进一步了解
                                  服务器规格。）
    测试列表                 可用的测试。使用空格对各个测试字段
                                  进行分隔。
                                  请参阅“备注”以了解更多信息。
    --^nettotalmb                  表示在网络测试中传输的
                                  用户数据量（以兆字节为单位），
                                  例如 "^serverDownloadTest" 或
                                  "^serverUploadTest"。
                                  值必须介于 "4" 到 "512" 之间。
                                  （默认值：16）
    --^networkiterations           表示要运行的
                                  "^serverDownloadTest" 和/或 "^serverUploadTest"
                                  的迭代次数。
                                  值必须介于 "1" 到 "100" 之间。
                                  （默认值：1）
    --^diskdatasize                表示将在 "^diskTest" 上写入
                                  并随后读取的数据量（以兆字节
                                  为单位）。
                                  值必须介于 "100" 到 "4096" 之间。
                                  （默认值：512）
    --^disktestpath                "^diskTest" 将测试文件写入到的
                                  路径。如果未提供此参数，
                                  该命令将尝试使用系统临时
                                  路径。
    --^systemdisplaytime           显示系统资源使用情况的时间间隔
                                  （单位：秒）。此选项可用于
                                  以下测试："^systemNetworkUsage"
                                  和 "^systemDiskUsage"。
                                  值必须介于 "1" 到 "3600" 之间。
                                  （默认值：5 秒）。
     --^systemdisplaytimeinterval  系统性能采样的时间间隔
                                  （单位：秒）。此选项可用于
                                  以下测试：
                                  "^systemNetworkUsage" 和 "^systemDiskUsage"。
                                  值必须介于 "1" 到 "60" 之间。
                                  （默认值：1 秒）。

== CMD_HELP_IOSTATS ==
备注：

    此命令要求在网速测试（"^serverUploadTest" 和/或
    "^serverDownloadTest"）期间使用可用的服务器。

    '--^diskTestPath' 必须指向属于要测试的物理
    磁盘驱动器的路径。如果未指定路径，该命令将尝试
    使用系统默认的临时路径。
    指定路径的磁盘驱动器必须具有足够的可用空间才能执行
    测试。

    在执行命令期间，执行的测试可能导致
    系统性能下降。

    可用的测试：
        --^serveruploadtest      （默认值）测量从 Plastic SCM 客户端到
                                服务器的数据上传速度。
        --^serverdownloadtest    （默认值）测量从 Plastic SCM 服务器到
                                客户端的数据下载速度。
        --^disktest              （默认值）测量磁盘读取速度和磁盘
                                写入速度。
        --^systemnetworkusage    显示当前的系统网络资源
                                使用情况。
                                （显示 Microsoft Windows 提供的网络接口
                                性能计数器）。
                                仅在 Microsoft Windows 中可用。
        --^systemdiskusage       显示当前的系统物理磁盘
                                使用情况。
                                （显示 Microsoft Windows 提供的网络接口
                                性能计数器）。
                                仅在 Microsoft Windows 中可用。

示例：

    cm ^iostats MYSERVER:8087 --^serveruploadtest --^serverdownloadtest --^nettotalmb=32

== CMD_DESCRIPTION_ISSUETRACKER ==
在指定的问题跟踪程序中获取、更新或查找问题状态。

== CMD_USAGE_ISSUETRACKER ==
用法：

    cm ^issuetracker <名称> ^status ^get <任务_ID> <参数>[ ...]
    cm ^issuetracker <名称> ^status ^update <任务_ID> <状态> <参数>[ ...]
    cm ^issuetracker <名称> ^status ^find <状态> <参数>[ ...]
    cm ^issuetracker <名称> ^connection ^check <参数>[ ...]
    
    名称                要连接的问题跟踪程序的名称。
                        目前仅支持 Jira。
    任务_ID             要查询或更新的问题的编号。
    ^status              问题跟踪程序中某个问题的有效状态。

Jira 参数（全部为必需参数）：

    --^user=<用户>         要验证身份的用户。
    --^password=<密码> 用于身份验证的密码。
    --^host=<URL>          问题跟踪程序的目标 URL。
    --^projectkey=<密钥>    Jira 项目的项目密钥。
    
== CMD_HELP_ISSUETRACKER ==
示例：

    cm ^issuetracker jira ^status ^get 11 --^user=user@mail.es --^password=pwd \
      --^host=https://user.atlassian.net --^projectkey=PRJ
    （获取 'PRJ' 项目的问题 11 的状态。）

    cm ^issuetracker jira ^status ^update 11 "完成" --^user=user@mail.es \
      --^password=pwd --^host=https://user.atlassian.net --^projectkey=PRJ
    （将 'PRJ' 项目的问题 11 的状态更新为“完成”。）
    
    cm ^issuetracker jira ^status ^find "完成" --^user=user@mail.es --^password=pwd \
      --^host=https://user.atlassian.net --^projectkey=PRJ
    （为 'PRJ' 项目获取相应状态设置为“完成”的任务 ID）

    cm ^issuetracker jira ^connection ^check --^user=user@mail.es --^password=pwd \
      --^host=https://user.atlassian.net --^projectkey=PRJ
    （检查配置参数是否有效。）

== CMD_DESCRIPTION_LICENSEINFO ==
显示许可证信息和许可证使用情况。

== CMD_USAGE_LICENSEINFO ==
用法：

    cm ^licenseinfo | ^li [--^server=<存储库服务器规格>] [--^inactive] [--^active]
                        [--^sort=(^name|^status)]

选项：

    --^server            从指定的服务器获取许可证信息。
                        如果未指定服务器，则在客户端上配置的
                        服务器上执行命令。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        服务器规格。）
    --^inactive          在“许可证使用情况”部分中仅显示非活动用户。
    --^active            在“许可证使用情况”部分中仅显示活动用户。
    --^sort              按指定的排序选项之一对用户进行排序：
                        '^name' 或 '^status'。

== CMD_HELP_LICENSEINFO ==
备注：

    显示的信息包括到期日期、已激活的用户和
    已停用的用户等。

示例：

    cm ^licenseinfo
    cm ^licenseinfo --^server=myserver:8084
    cm ^licenseinfo --^sort=^name

== CMD_DESCRIPTION_LINKTASK ==
将变更集链接到任务。

== CMD_USAGE_LINKTASK ==
这是一个自动化命令，仅用于自动执行 'cm'。
此命令的用户友好度不如预期。

用法：

    cm ^linktask | ^lt <变更集规格> <扩展前缀> <任务名称>

    变更集规格            要链接到任务的完整变更集规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）
    扩展前缀          要使用的已配置问题跟踪系统的
                        扩展前缀。
    任务名称           问题跟踪系统上的任务标识符。

== CMD_HELP_LINKTASK ==
示例：

    cm ^lt ^cs:8@^rep:default@^repserver:localhost:8084 jira PRJ-1

== CMD_DESCRIPTION_LOCK_LIST ==
显示服务器上的锁定情况。

== CMD_USAGE_LOCK_LIST ==
用法：

    cm ^lock ^list | ^ls [<修订规格 > [ ...]] [--^server=<服务器>]
                      [--^onlycurrentuser] [--^onlycurrentworkspace]
                      [--^ignorecase]

    修订规格             如果存在一个或多个修订，则此命令将
                        为每个指定的修订显示一个锁定行
                        （如果在服务器中锁定了该修订的关联项）。否则，
                        此命令将列出默认服务器中的所有锁定项
                        （或者使用 '--^server' 选项来设置的已锁定项）
                        使用多个修订规格时，使用空格对各个修订规格
                        进行分隔。
                        （使用 'cm ^help ^objectspec' 可进一步了解修订规格。）

选项：

    --^server                存储库服务器规格。
                            此选项将覆盖从当前工作区
                            或 client.conf 文件检索到的默认
                            服务器。
                            （使用 'cm ^help ^objectspec' 可进一步了解
                            服务器规格。）
    --^onlycurrentuser       筛选结果，仅显示当前用户
                            执行的锁定。
    --^onlycurrentworkspace  筛选结果，仅显示对当前工作区
                            执行的锁定（按名称进行匹配）。
    --^ignorecase            使用服务器路径规格时，忽略路径中的
                            大小写。使用此标志后，即使用户写入 "/sRc/fOO.c"，
                            该命令也将对 "/src/foo.c" 有效。

== CMD_HELP_LOCK_LIST ==
备注：

    该命令将列出默认服务器中当前
    已锁定的项。该命令还接受若干修订规格；在这种
    情况下，仅显示属于所选项的锁定。
    可使用 '--^server=<服务器>' 来设置要查询的默认服务器。

    该命令针对指定服务器中的每个锁定都会显示一行：
        - 已锁定项的 GUID。
        - 执行锁定的用户名。
        - 锁定操作所在的工作区的名称。
        - 锁定项的路径（服务器路径格式）。

示例：

    cm ^lock ^list
    cm ^lock ^list --^server=myserver:8084
    cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
    cm ^lock ^list ^revid:3521@default ^itemid:2381@secondary --^onlycurrentuser
    cm ^lock ^ls --^onlycurrentuser
    cm ^lock ^ls --^onlycurrentuser --^onlycurrentworkspace

== CMD_DESCRIPTION_LISTUSERS ==
列出用户和组。

== CMD_USAGE_LISTUSERS ==
用法：

    cm ^listusers | ^lu <存储库服务器规格> [--^onlyusers] [--^onlygroups]
                      [--^filter= <筛选器字符串>]

    存储库服务器规格       存储库服务器规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）

选项：

    --^onlyusers         仅列出用户。
    --^onlygroups        仅列出组。
    --^filter            仅列出匹配指定筛选器的用户
                        和/或组。

== CMD_HELP_LISTUSERS ==
示例：

    cm ^lu localhost:8084
    （列出服务器中的所有用户。）

    cm ^listusers localhost:8084 --^onlyusers --^filter=m
    （仅列出服务器中包含 "m" 的用户。）

== CMD_DESCRIPTION_LOCATION ==
返回 'cm' 的路径。

== CMD_USAGE_LOCATION ==
用法：

    cm ^location

== CMD_HELP_LOCATION ==

== CMD_DESCRIPTION_LOCK ==
此命令允许用户管理锁定。

== CMD_USAGE_LOCK ==
用法：

    cm ^lock <命令> [选项]

命令：

    ^list | ^ls
    ^unlock

    要获取有关每条命令的更多信息，请运行：
    cm ^lock <命令> --^usage
    cm ^lock <命令> --^help

== CMD_HELP_LOCK ==
示例：

    cm ^lock ^list
    cm ^lock
    （如果没有参数，则 '^list' 为可选项。）
    cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
    cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5

== CMD_DESCRIPTION_LOG ==
获取有关变更集内的修订的信息。

== CMD_USAGE_LOG ==
用法：

    cm ^log [<变更集规格> | <存储库规格>] [--^from=<变更集规格起点>] [--^allbranches]
           [--^ancestors] [--^csformat=<格式字符串>] [--^itemformat=<格式字符串>]
           [--^xml[=<输出文件>]] [--^encoding=<名称>]
           [--^repositorypaths | --^fullpaths | --^fp]

选项：

    变更集规格            该命令将返回在相应规格的变更集内
                        所做的所有更改。
                        （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）
    存储库规格             该命令将列出在指定存储库中进行的
                        所有更改。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        规格。）
    --^from              列出从变更集规格 [变更集规格起点]
                        到变更集规格 [变更集规格] 的每个变更集内
                        进行的所有更改。
                        [变更集规格起点] 变更集不包含在
                        输出中。
                        提供存储库规格后会忽略此选项。
    --^allbranches       对于创建了相应变更集的所有分支，
                        显示指定时间间隔内创建的
                        这些变更集的相关信息。
    --^ancestors         显示可通过给定变更集（[变更集规格]）的
                        父链接和合并链接来访问的变更集
                        的相关信息。如果也提供了起点
                        变更集（[变更集规格起点]），此变更集将用作
                        所有路径的下限。备注：使用此选项时，
                        不会显示变更集更改。
    --^csformat          检索特定格式的变更集信息。请参阅
                        “备注”以了解更多信息。
    --^itemformat        检索特定格式的项信息。请参阅
                        “备注”以了解更多信息。
    --^xml               以 XML 格式将输出打印到标准输出。
                        可以指定输出文件。
    --^encoding          与 '--^xml' 选项结合使用，指定要在 XML 输出
                        中使用的编码（例如：utf-8）。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。
    --^fullpaths, --^fp   如果可能，强制打印文件和目录的完整
                        工作区路径。
    --^repositorypaths   打印存储库路径（服务器路径）
                        而不是工作区路径。（此选项将覆盖
                        '--^fullpaths' 选项。）

== CMD_HELP_LOG ==
备注：

    - 如果“变更集规格”和选项均未指定，该命令将显示
      每个分支中上个月内创建的每个变更集的
      相关信息。
    - 如果仅包含 '--^from' 选项，该命令显示
      在创建指定变更集的分支中从该变更集到最后一个
      变更集的每个变更集的相关信息。
    - 如果显示不带时间间隔的选项 '--^allbranches'，
      该命令会检索与仅指定“变更集规格”时相同的
      信息。
    - 如果使用 '--^from'，输出包含从“变更集规格起点”+1 开始的
      变更集的信息。
    - 用于显示变更集信息的存储库就是在执行命令的
      路径中加载的存储库。

    此命令接受项的格式字符串 ('--^itemformat') 以及
    变更集的格式字符串 ('--^csformat')。

    '--^csformat' 的输出参数如下：
        {^tab}           插入一个制表符空格位。
        {^newline}       插入一个新行。
        {^changesetid}   变更集编号。
        {^branch}        在其中创建变更集的分支。
        {^date}          变更集的日期。
        {^owner}         变更集的所有者。
        {^comment}       变更集的注释。
        {^items}         变更集内涉及的项。
        {^repository}    变更集所在的存储库。
        {^repserver}     服务器名称。

    '--^itemformat' 的输出参数如下：
        {^tab}           插入一个制表符空格位。
        {^newline}       插入一个新行。
        {^path}          项路径。
        {^branch}        在其中创建变更集的分支。
        {^date}          变更集的日期。
        {^owner}         变更集的所有者。
        {^shortstatus}   打印短格式。请参阅下文。
        {^fullstatus}    打印长格式。请参阅下文。

        短格式及其对应的长格式：
            '^A'   ^Added
            '^D'   ^Deleted
            '^M'   ^Moved
            '^C'   ^Changed

    这些是有效的输出字符串：
        --^csformat="{^newline}变更集 {^changesetid} 创建于 {^date}；{^tab} 已更改项：{^items}。"
        --^itemformat="{^newline}分支 {^branch} 中的项 {^path} 已更改。"

示例：

    cm ^log
    （显示每个分支中上个月创建的每个变更集的相关
    信息。）

    cm ^log ^cs:16
    （显示在其中创建变更集的分支内的变更集 16 中
    所做更改的相关信息。）

    cm ^log ^cs:16 --^csformat="{^newline}变更集 {^changesetid} 创建于 \
      {^date}；{^tab} 已更改项：{^items}。"
    （按指定格式显示此信息。）

    cm ^log --^from=^cs:20 ^cs:50
    （显示从变更集 21 到变更集 50 的每个变更集中包含的
    每个修订的相关信息。）

    cm ^log --^from=^cs:20 ^cs:50 --^allbranches
    （显示存储库的每个分支中从变更集 21 到
    变更集 50 的每个变更集中包含的每个修订的
    相关信息。）

    cm ^log ^rep:myrep@localhost:8084
    （显示在指定存储库中进行的更改的相关信息。
    无需工作区也可运行此命令。）

    cm ^log --^from=^cs:20@^rep:mainRep@localhost:8084
    （显示从变更集 21 开始的每个变更集内包含的每个修订
    的相关信息。无需工作区也可运行此命令，因为
    已指定完整变更集规格。）

== CMD_DESCRIPTION_LS ==
列出树的内容。

== CMD_USAGE_LS ==
用法：

    cm ^ls | ^dir [<路径>[ ...]] [--^format=<格式字符串>] [--^symlink]
                [--^selector[=<选择器格式>]] [--^tree=<对象规格>]
                [-^R | -^r | --^recursive]
                [--^xml[=<输出文件>]] [--^encoding=<名称>]

选项：

    路径               要显示的路径的列表。使用空格对各个路径进行
                        分隔。
                        使用双引号 (" ") 指定包含空格的
                        路径。
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^symlink           将操作应用于符号链接而不是
                        目标。
    --^selector          从活动的工作区选择器获取内容。
                        如果已指定选择器格式，则列出
                        指定的选择器。
                        自 Plastic SCM 4.x 开始，选择器不再是 Plastic SCM
                        的重要特性，因此大多数情况下已弃用。
    --^tree              列出指定变更集或分支中的树。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）
    -^R                  以递归方式列出。
    --^xml               以 XML 格式将输出打印到标准输出。
                        可以指定输出文件。
    --^encoding          与 '--^xml' 选项结合使用，指定要在 XML 输出
                        中使用的编码（例如：utf-8）。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。

== CMD_HELP_LS ==
备注：

    - 可以使用元字符来键入路径。
    - 此列表取决于工作区选择器。
    - 可以指定格式字符串，从而将命令的输出格式化。
    - 如果指定 '--^tree' 或 '--^selector' 选项，则给定的
      路径必须是服务器路径（也就是：'cm path'）：/dir/file.txt，而不是
      工作区路径：C:\Users\myuser\mywk\dir\file.txt
    - 如果未提供路径，则认为工作区路径是当前
      目录。如果使用 '--^tree' 或 '--^selector' 选项，
      则采用根路径 ("/")。

    默认格式字符串为：
      "{^size,10} {^date:dd/MM/yyyy} {^date:HH:mm}\
       {^type,-6} {^location,-12} {^checkout,-5} {^name}\
       {^symlinktarget}"

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {^size}
        {^formattedsize}
        {^date}
        {^type}
            ^dir     目录，
            ^txt     文本文件，
            ^File    文件。
        {^location}      示例：^br:branch#cset
        {^checkout}
        {^name}
        {^changeset}
        {^path}
        {^repspec}
        {^owner}
        {^revid}
        {^parentrevid}
        {^itemid}
        {^brid}
        {^repid}
        {^server}
        {^symlinktarget}
        {^hash}
        {^chmod}
        {^wkpath}        相对于工作区根目录的路径
        {^branch}
        {^newlocation}   cset@branch
        {^guid}          （将需要更长时间来解析）
        {^itemguid}
        {^transformed}   显示已变换项的适用规则

    可以设置 PLASTIC_LS_FORMAT 环境变量以便自定义
    '^ls' 格式。

示例：

    cm ^ls
    cm ^ls c:\workspace\src

    cm ^ls --^format={^name}
    （仅文件名。）

    cm ^ls --^symlink
    （显示有关符号链接的信息，而不是“符号链接”的文件或
    目录。适用于 UNIX 环境。）

    cm ^ls code --^selector
    （显示当前工作区选择器中 'code' 子目录的
    内容。）

    cm ^ls /code --^selector="^rep 'myrep' ^path '/' ^branch '/^main'"
    （显示指定选择器中 '/code' 子目录的内容。
    请注意，该路径是按服务器格式指定的。）

    cm ^ls /code --^tree=44@myrep@denver:7070
    （列出服务器 'denver:7070' 存储库 'myrep' 变更集 44 的
    '/code' 子目录。）

    cm ^ls /code --^tree=^br:/main/scm13596@myrep@denver:7070
    （列出服务器 'denver:7070' 存储库 'myrep' 分支
    '/main/scm13596' 中的最新变更集的 '/code' 子目录。）

    cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070
    （列出服务器 'denver:7070' 存储库 'myrep'
    的变更集 ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 的
    '/code' 子目录。）

== CMD_DESCRIPTION_TRIGGER_LIST ==
列出服务器上给定类型的触发器。

== CMD_USAGE_TRIGGER_LIST ==
用法：

    cm ^trigger | ^tr ^list | ^ls [<子类型-类型>] [--^server=<存储库服务器规格>]
                          [--^format=<格式字符串>]

选项：

    子类型-类型        触发器执行和触发器操作。
                        键入 'cm ^showtriggertypes' 可查看触发器类型
                        列表。
    --^server            列出指定服务器上的触发器。
                        如果未指定服务器，则在客户端上配置的
                        服务器上执行命令。
                        （使用 'cm ^help ^objectspec' 可进一步了解服务器
                        规格。）
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。

== CMD_HELP_TRIGGER_LIST ==
备注：

    如果未指定类型，则列出服务器上的所有触发器。

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0}             触发器位置。
        {1}             触发器名称。
        {2}             触发器路径。
        {3}             触发器所有者。
        {4}             触发器类型。
        {5}             触发器筛选器。

示例：
    cm ^trigger list after-mklabel
    cm ^tr ^ls ^before-mkbranch --^server=myserver:8084

== CMD_DESCRIPTION_MANIPULATESELECTOR ==
将选择器更改为日期。

== CMD_USAGE_MANIPULATESELECTOR ==
这是一个自动化命令，仅用于自动执行 'cm'。
此命令的用户友好度不如预期。

用法：

    cm ^manipulateselector | ^ms [<工作区路径> | <工作区规格>] --^atdate=<选择器日期>

    工作区路径             工作区的路径。
    工作区规格             工作区的规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解规格。）
选项：

    --^atdate            返回一个选择器以用于重新创建工作区，
                        就像在指定日期看到的工作区一样。

== CMD_HELP_MANIPULATESELECTOR ==
备注：

    如果路径和工作区规格均未指定，则该命令将采用
    当前目录作为工作区路径。

示例：

    cm ^manipulateselector c:\workspace --^atdate=yyyy-MM-ddTHH:mm:ss
    cm ^manipulateselector --^atdate=yyyy-MM-ddTHH:mm:ss
    cm ^manipulateselector > mySelector.txt --^atdate=yyyy-MM-ddTHH:mm:ss
    cm ^manipulateselector ^wk:build_wk@BUILDER --^atdate=yyyy-MM-ddTHH:mm:ss

== CMD_DESCRIPTION_MERGE ==
将一个分支与另一个分支合并。

== CMD_USAGE_MERGE ==
用法：

    cm ^merge <源规格> [--^merge] [--^cherrypicking] [--^forced]
                           [--^mergetype=(^onlyone|^onlysrc|^onlydst|^try|^forced)]
                           [--^interval-origin=<变更集规格> | --^ancestor=<变更集规格>]
                           [--^keepsource | --^ks] [--^keepdestination | --^kd]
                           [--^automaticresolution=<冲突类型>[;...]]
                           [--^subtractive] [--^mount] [--^printcontributors]
                           [--^noprintoperations] [--^silent]
                           [(--^to=<分支规格> | --^destination=<分支规格>)[--^shelve]]
                           [--^no-dst-changes]
                           [-^c=<注释字符串> | --^commentsfile=<注释文件>]
                           [--^resolveconflict --^conflict=<索引>
                           --^resolutionoption=(^src|^dst|(^rename --^resolutioninfo=<字符串名称>))
                           --^mergeresultfile=<路径> --^solvedconflictsfile=<路径>]
                           [--^nointeractiveresolution]
                           [--^machinereadable [--^startlineseparator=<分隔符>]
                             [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

    源规格           要合并的源对象的规格：
                          - 分支规格：'[^br:/]br_name'
                          - 标签规格：'^lb:lb_name'
                          - 变更集规格：'^cs:cs_number'
                          - 搁置规格：'^sh:shelve_number'
                          （使用 'cm ^help ^objectspec' 可进一步了解规格。）

选项：

    --^merge                   执行合并。否则，打印找到的
                              冲突。
    --^cherrypicking           合并源变更集内包含的
                              变更。如果合并源规格是标签，
                              则不会使用此选项。
    --^forced                  不检查源和目标是否
                              已连接。
                              此选项仅可用于间隔合并
                              和挑拣。
    --^mergetype               请参阅“备注”以了解更多信息。
    --^interval-origin         指定将哪个变更集选为
                              间隔原点，以便合并仅考虑
                              源变更集与指定间隔原点
                              之间的差异。
    --^ancestor                这是 --^interval-origin 的别名。
    --^keepsource              对于有冲突的项，接受源参与者
                              的所有更改。
    --^keepdestination         对于有冲突的项，保留目标参与者
                              的更改。
    --^automaticresolution     用于解决目录冲突。此选项
                              可让您决定应该自动选择
                              源参与者还是目标参与者
                              来解决冲突。
                              使用分号对各个冲突类型进行分隔。
                              请参阅“备注”以了解更多信息。
    --^subtractive             删除由合并引入的更改。传递给
                              命令的参数（源规格）用于
                              指定要删除哪个源的
                              更改。必须是变更集。如果是变更集
                              间隔，必须使用 '--^interval-origin' 来
                              定义间隔原点。为了删除更改，
                              系统将创建一个新的已签出修订，
                              该修订将具有上一个
                              修订的内容（不包含已删除的更改）。
    --^mount                   给定存储库的装入点。
    --^printcontributors       打印参与者（基项、源和
                              目标）。
    --^noprintoperations       以静默方式解决合并问题，
                              不显示有关解决情况的信息。
    --^silent                  不显示任何输出。
    --^to | --^destination      对指定分支执行“合并到”操作
                              （通过输入分支规格）
                              并完全解决冲突。
                              “合并到”（或无工作区的合并）是在
                              服务器端进行的合并。正常的合并
                              发生在“从”分支、标签或变更集合并的
                              工作区上，而“合并到”完全发生
                              在服务器上。在正常合并中，
                              “目标”是工作区，而在“合并到”中，
                              必须始终指定目标（这就是称之为
                              “到”的原因）。
                              请查看以下链接以了解关于
                              “合并到”功能的更多信息：
                              https://www.plasticscm.com/download/help/mergeto
    --^shelve                  使用合并结果的更改（加上合并
                              可追溯性信息）来创建一个搁置，
                              而不是创建新的变更集。合并源为
                              搁置时，此选项不可用。该选项
                              仅可用于服务器端合并
                              （又称为“合并到”）。因此，需要 '--^to' 和
                              '--^merge' 选项。
    --^no-dst-changes          确保目标参与者不具有
                              更改（目标变更集也是
                              共同上级）。目标上存在更改时，
                              不允许合并。
    -^c                        将指定的注释应用于合并操作中
                              创建的变更集。
    --^commentsfile            将指定文件中的注释应用于合并操作中
                              创建的变更集。
    --^resolveconflict         （主要由插件使用。请参阅“备注”以了解更多信息。）
                              用于解决目录冲突。
    --^conflict                与 '--^resolveconflict' 标志结合使用，指定
                              要解决的冲突的索引（从 1 开始）。
    --^resolutionoption        与 '--^resolveconflict' 标志结合使用，指示
                              冲突解决类型。使用以下
                              选项之一：'^src'、'^dst'、'^rename'。
                              请参阅“备注”以了解更多信息。
    --^resolutioninfo          与 '--^resolveconflict' 标志结合使用，提供在
                              '--^resolutionoption' 选项为 'rename' 时
                              要使用的名称。
    --^mergeresultfile         与 '--^resolveconflict' 标志结合使用，将
                              不同调用之间的合并结果的信息
                              输出到文件中。指定的路径将在第一次
                              调用期间创建，并在每个后续
                              调用时更新。
    --^solvedconflictsfile     与 '--^resolveconflict' 标志结合使用，
                              将不同调用之间已解决的冲突
                              的信息输出到文件中。指定的路径
                              将在第一次调用期间创建，并在每个
                              后续调用时更新。
    --^nointeractiveresolution （主要由插件使用。请参阅“备注”以了解更多信息。）
                              避免提示用户已发生手动冲突。
                              这样就不会解决目录冲突。
    --^machinereadable         （主要由插件使用。请参阅“备注”以了解更多信息。）
                              以易于解析的格式输出结果。
    --^startlineseparator      与 '--^machinereadable' 标志结合使用，指定
                              行应如何开头。（默认值：空字符串。）
    --^endlineseparator        与 '--^machinereadable' 标志结合使用，指定
                              行应如何结尾。（默认值：空字符串。）
    --^fieldseparator          与 '--^machinereadable' 标志结合使用，指定
                              应如何分隔字段。（默认值：
                              空格。）

== CMD_HELP_MERGE ==
备注：

    此命令用于合并两个分支之间或标签与
    分支之间的更改。合并的目标必须始终为分支。
    合并源将指定为参数。
    目标是工作区的当前内容。
    例如，要显示从分支 task001 合并到主分支
    的元素，选择器必须指向主分支，
    工作区必须完成更新，然后：
        cm ^merge ^br:/task001

    添加 '--^merge' 选项来切实执行合并：
        cm ^merge ^br:/task001 --^merge

    要定义合并源，可以使用以下规格：

    - 分支规格：
        [^br:/]br_name
        示例：^br:/main/task001
        （以上示例从此分支上的最后一个变更集执行合并。）

    - 标签规格：
        ^lb:lb_name
        示例：^lb:BL001
        （从标记的变更集合并。）

    - 变更集规格：
        ^cs:cs_number
        示例：^cs:25
        （从给定的变更集内容合并。）

    - 搁置规格：
        ^sh:shelve_number
        示例：^sh:2
        （从给定的搁置内容合并。）

    要自动解决目录冲突，请使用 '--^automaticresolution'
    选项并指定冲突类型，然后指定在合并操作
    期间必须选择的参与者（源或目标）。
    （使用分号 (;) 对各个“冲突类型”-“参与者”对进行分隔。）
    例如：
        cm ^merge ^cs:2634 --^merge --^automaticresolution=^eviltwin-src;^changedelete-src
        （自变更集 2634 开始的合并操作将会解决 "^eviltwin" 和
        "^changedelete" 冲突，解决方法是在两种情况下保留源 ("-^src")
        参与者）。
    - 冲突类型之后的 "-^src" 后缀告诉合并命令保留
      源参与者更改。
    - "-^dst" 后缀将保留目标参与者更改。
    以下是合并命令支持的冲突类型的列表：
      "^movedeviltwin"、"^eviltwin"、"^changedelete"、"^deletechange"、"^movedelete"、
      "^deletemove"、"^loadedtwice"、"^addmove"、"^moveadd"、"^divergentmove"、
      "^cyclemove"、"^all"。
    "^all" 值会覆盖其他选项。在以下示例中，
    "^eviltwin-dst" 将被忽略：
        cm ^merge ^br:/main/task062 --^merge --^automaticresolution=^all-src;^eviltwin-dst
    请查看以下链接以了解关于合并冲突的更多信息：
    https://www.plasticscm.com/download/help/directorymerges

    以下是 '--^mergetype' 的选项：
        ^onlyone         仅有一个参与者修改了该项的情况下，才进行
                        自动合并。
        ^onlysrc         仅有一个源参与者修改了该项的情况下，才进行
                        自动合并。
        ^onlydst         仅有一个目标参与者修改了该项的情况下，才进行
                        自动合并。
        ^try             仅有一个参与者修改了冲突代码段（每个冲突）
                        的情况下，才进行自动合并。
        ^forced          始终尝试解决所有非自动冲突。

    以下是主要由插件和集成使用的选项：
        - '--^resolveconflict'，用于解决目录冲突。还必须使用
          以下选项：
              - '--^conflict' 是要解决的冲突的索引
                （从 1 开始）。
              - '--^resolutionoption' 指示要使用的冲突解决
                 方法。选项可以是：
                    - '^src'，用于保留源更改而放弃
                      目标更改
                    - '^dst'，用于保留目标更改而放弃
                      源更改
                    - '^rename'（仅在冲突类型支持此解决方法
                      的情况下），用于将目标重命名为
                      通过 '--^resolutioninfo' 选项提供的给定名称。
                        - '--^resolutioninfo'，用于提供在 '^rename' 解决
                          方法中使用的名称
              - '--^mergeresultfile' 和 '--^solvedconflictsfile'，这两者用于
                存储不同调用之间的合并信息。
        - '--^nointeractiveresolution' 指示合并操作不要求用户
          进行手动冲突解决。
        - '--^machinereadable' 和 '--^startlineseparator'、'--^endlineseparator'、
          '--^fieldseparator' 选项，用于以机器可读的方式
          （易于解析）打印输出。
        示例：
        cm ^merge --^machinereadable --^startlineseparator=start@_@line \
          --^endlineseparator=new@_@line --^fieldseparator=def#_#sep \
          --^mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \
          --^solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \
          --^resolveconflict --^conflict=1 --^resolutionoption=rename  \
          --^resolutioninfo=bin_dst ^br:/main/task --^merge

示例：

    cm ^merge ^br:/task001
    （不合并，仅打印要合并的项。）

    cm ^merge ^br:/task001 --^merge
    （从分支 'task001' 进行合并。）

    cm ^merge ^cs:5 --^merge --^cherrypicking --^interval-origin=^cs:2
    （从变更集间隔 (2,5] 进行挑拣。）

    cm ^merge ^cs:8 --^merge --^subtractive --^keepdestination
    （从变更集 8 进行减法合并，保留那些有冲突的
    元素的目标更改。）

    cm ^merge ^br:/main/task001 --^to=^br:/main --^merge -^c="集成的新 UI"
    （进行从分支 'task001' 到分支 'main' 的服务器端合并
    （又称为“合并到”），并设置注释。）

    cm ^merge ^br:/main/task001 --^to=^br:/main --^merge --^shelve
    （进行从分支 'task001' 到分支 'main' 的服务器端合并，
    并将结果保留在搁置中。）

    cm ^merge ^sh:2 --^to=^br:/main --^merge --^no-dst-changes
    （仅在从当前的 'main' 头部创建时，才将搁置 2
    应用于 'main'）

== CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
创建新的属性。

== CMD_USAGE_ATTRIBUTE_CREATE ==
用法：

    cm ^attribute | ^att ^create | ^mk <属性名>

    属性名            属性名称

== CMD_HELP_ATTRIBUTE_CREATE ==
示例：

    cm ^attribute ^create 状态
    （创建属性 '状态'。）

    cm ^att ^mk 集成
    （创建属性 '集成'。）

== CMD_DESCRIPTION_BRANCH ==
允许用户管理分支。

== CMD_USAGE_BRANCH ==
用法：

    cm ^branch | ^br <命令> [选项]

命令：

    ^create | ^mk
    ^delete | ^rm
    ^rename
    ^history
    ^showmain
    ^showmerges

    要获取有关每条命令的更多信息，请运行：
    cm ^branch <命令> --^usage
    cm ^branch <命令> --^help

== CMD_HELP_BRANCH ==
示例：

    cm ^branch /main/scm21345
    cm ^branch ^create /main/scm21345
    cm ^branch ^delete /main/scm21345
    cm ^branch ^rename /main/scm21345 scm21346
    cm ^branch ^history /main/scm21345
    cm ^branch ^showmain
    cm ^branch ^showmerges file.txt

== CMD_DESCRIPTION_BRANCH_CREATE ==
创建新的分支。

== CMD_USAGE_BRANCH_CREATE ==
用法：

    cm ^branch | ^br [^create | ^mk] <分支规格>
                   [--^changeset=<变更集规格> | --^label=<标签规格>]
                   [-^c=<注释字符串> | -^commentsfile=<注释文件>]

    分支规格         新分支名称或规格。
                   （使用 'cm ^help ^objectspec' 可进一步了解分支规格。）

选项：

    --^changeset     用作新分支的起点的变更集。
                    （使用 'cm ^help ^objectspec' 可进一步了解变更集规格。）
    --^label         用作新分支的起点的标签。
                    （使用 'cm ^help ^objectspec' 可进一步了解标签规格。）
    -^c              用指定的文本填充新分支的“注释”
                    字段。
    -^commentsfile   用指定文件的内容填充新分支的“注释”
                    字段。

== CMD_HELP_BRANCH_CREATE ==
备注：

    要创建顶级分支，请指定不含任何层次结构的名称。
    例如：

        cm ^br /dev

    如果未指定可选参数 '--^changeset'，新分支的基项
    将是父分支上的最后一个变更集。如果新分支
    是顶级分支，则使用的基础变更集将为变更集 0。

    可以使用 '-^c' 或 '-^m' 开关来指定注释：

        cm ^branch /main/task001 -^c="这是注释"
        cm ^branch /main/task001 -^m "这是注释"

    设置 PLASTICEDITOR 环境变量可指定用于输入注释的
    编辑器。如果已设置 PLASTICEDITOR 环境变量，
    并且注释为空，则会自动启动编辑器
    以用于指定注释。

示例：

    cm ^branch task001
    cm ^branch ^create task001
    cm ^branch ^mk task001
    cm ^br ^mk task001
    （在当前工作区的存储库中创建顶级分支
    'task001'。）

    cm ^branch ^br:/task001/task002@
    （创建 'task002' 分支作为 'task001' 的子级。）

    cm ^br /main/task001@myrep@myserver:8084 -^c="我的注释"
    （在存储库 'myrep@myserver:8084' 中，创建 'task001' 分支
    作为 'main' 的子级，并包含注释 '我的注释'。）

    cm ^branch ^br:/main/task001 --^changeset=2837 -^commentsfile=commenttask001.txt
    （创建 'task001' 分支作为 'main' 的子级，基础变更集 'changeset=2837'，
    并应用 'commenttask001.txt' 文件中的注释。）

== CMD_DESCRIPTION_BRANCH_DELETE ==
删除一个或多个分支。

== CMD_USAGE_BRANCH_DELETE ==
用法：

    cm ^branch | ^br ^delete | ^rm <分支规格>[ ...]

    分支规格              要删除的分支。使用空格对各个分支进行分隔。
                        （使用 'cm ^help ^objectspec' 可进一步了解分支
                        规格。）

== CMD_HELP_BRANCH_DELETE ==
备注：

    此命令将删除一个或多个分支。

示例：

    cm ^branch ^delete /main/task001
    （在当前工作区的存储库中删除名为 'task001' 分支
    （'main' 的子级）。）

    cm ^br ^rm main/task002 /main/task012@reptest@myserver:8084
    （删除当前工作区的存储库中的分支 '/main/task002 
    以及存储库 'reptest@myserver:8084' 中的分支 '/main/task012'。）

== CMD_DESCRIPTION_BRANCH_RENAME ==
重命名分支。

== CMD_USAGE_BRANCH_RENAME ==
用法：

    cm ^branch | ^br ^rename <分支规格> <新名称>

    分支规格          要重命名的分支。
                    （使用 'cm ^help ^objectspec' 可进一步了解分支规格。）
    新名称        分支的新名称。

== CMD_HELP_BRANCH_RENAME ==
备注：

    此命令将重命名分支。

示例：

    cm ^branch ^rename /main/task0 task1
    （将分支 '/main/task0' 重命名为 '/main/task1'。）

    cm ^br ^rename ^br:/main@reptest@server2:8084 secondary
    （将存储库 'reptest' 的 'main' 分支重命名为 'secondary'。）

== CMD_DESCRIPTION_BRANCH_HISTORY ==
显示分支的历史记录。

== CMD_USAGE_BRANCH_HISTORY ==
用法：

    cm ^branch | ^br ^history <分支规格> [--^dateformat=<日期格式>]
                           [--^machinereadable]

    分支规格          用于获取历史记录的分支规格。
                    （使用 'cm ^help ^objectspec' 可进一步了解分支规格。）

选项：

    --^dateformat            用于输出日期的格式。
    --^machinereadable       以易于解析的格式输出结果。

== CMD_HELP_BRANCH_HISTORY ==
示例：

    cm ^branch ^history ^br:/main/scm001@myrepository@myserver:8084
    （显示 'myserver' 服务器中的 'myrepository' 存储库的 '/main/scm001'
    分支的历史记录。）

    cm ^br ^history main --^dateformat="yyyy, dd MMMM" --^machinereadable
    （以给定的日期格式和易于解析的格式，显示当前
    存储库的 'main' 分支的历史记录。）

== CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
显示存储库的主分支。
这是一个自动化命令，仅用于自动执行 'cm'。
存储库的主分支很有可能是 '/main'。

== CMD_USAGE_BRANCH_SHOWMAIN ==
用法：

    cm ^branch | ^br ^showmain [<存储库规格>] [--^encoding=<名称>]
                            [--^format=<格式字符串>] [--^dateformat=<日期格式>]

    存储库规格             要显示分支的存储库
                        规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库规格。）

选项：

    --^encoding          指定输出中使用的编码，
                        如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^dateformat        用于输出日期的格式。

== CMD_HELP_BRANCH_SHOWMAIN ==
备注：

    此命令将显示存储库的主分支。

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {^id}                分支 ID。
        {^comment}           注释。
        {^date}              日期。
        {^name}              名称。
        {^owner}             所有者。
        {^parent}            父分支名称。
        {^repository}        存储库。
        {^repname}           存储库名称。
        {^repserver}         服务器。
        {^changeset}         分支的头部变更集。

示例：

    cm ^branch ^showmain
    （显示当前工作区的存储库的主分支。）

    cm ^branch ^showmain repo@server:8084
    （显示服务器 'server:8084' 中的存储库 'repo' 的
    主分支。）

    cm ^br ^showmain --^dateformat="yyyy, dd MMMM" --^encoding=utf8
    （以给定日期格式显示存储库的主分支，
    输出编码为 utf8。）

    cm ^br ^showmain --^format="{^id} - {^name}"
    （显示存储库的主分支，仅打印其 ID 和名称。）

== CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
显示待合并的分支。

== CMD_USAGE_BRANCH_SHOWMERGES ==
这是一个自动化命令，仅用于自动执行 'cm'。
此命令的用户友好度不如预期。

用法：

    cm ^branch | ^br ^showmerges <项路径>[ ...]
                              [--^format=<格式字符串>]
                              [--^dateformat=<日期格式>]

选项：
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^dateformat        用于输出日期的格式。

== CMD_HELP_BRANCH_SHOWMERGES ==
备注：

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {^id}                分支 ID。
        {^comment}           注释。
        {^date}              日期。
        {^name}              名称。
        {^owner}             所有者。
        {^parent}            父分支名称。
        {^parentid}          父分支 ID。
        {^repid}             存储库 ID。
        {^repository}        存储库。
        {^repname}           存储库名称。
        {^repserver}         存储库服务器。

示例：

    cm ^branch ^showmerges file.txt
    （显示 'file.txt' 的待定合并中涉及的分支。）

    cm ^branch ^showmerges file.txt --^format="{^date} {^name}" --^dateformat="yyMMdd"
    （显示合并中涉及的分支，仅以给定的日期格式打印
    日期和名称。）

== CMD_DESCRIPTION_REPOSITORY ==
允许用户管理存储库。

== CMD_USAGE_REPOSITORY ==
用法：

    cm ^repository | ^repo <命令> [选项]

命令：

    ^create | ^mk
    ^delete | ^rm
    ^list   | ^ls
    ^rename
    ^add

    要获取有关每条命令的更多信息，请运行：
    cm ^repository <命令> --^usage
    cm ^repository <命令> --^help

== CMD_HELP_REPOSITORY ==
示例：

    cm ^repository
    cm ^repository ^list
    cm ^repository 新存储库
    cm ^repository ^create 新存储库
    cm ^repository ^rename 旧名称 新名称
    cm ^repository ^add C:\repo\

== CMD_DESCRIPTION_REPOSITORY_CREATE ==
在服务器上创建存储库。

== CMD_USAGE_REPOSITORY_CREATE ==
用法：

    cm ^repository | ^repo <存储库名称>
    cm ^repository | ^repo <存储库服务器规格> <存储库名称>[ ...]
    cm ^repository | ^repo [^create | ^mk] <存储库名称>

    存储库服务器规格       存储库服务器规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        服务器规格。）
    存储库名称            一个或多个新存储库的名称。
                        使用空格对各个存储库名称进行分隔。

== CMD_HELP_REPOSITORY_CREATE ==
示例：

    cm ^repository MyRep
    cm ^repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
    cm ^repo ^create Rep01
    cm ^repo ^mk 列表

== CMD_DESCRIPTION_REPOSITORY_DELETE ==
从服务器删除存储库。

== CMD_USAGE_REPOSITORY_DELETE ==
用法：

    cm ^repository | ^repo ^delete | ^rm <存储库规格>

选项：

    存储库规格            存储库的规格。
                       （使用 'cm ^help ^objectspec' 可进一步了解存储库规格。）

== CMD_HELP_REPOSITORY_DELETE ==
备注：

    从存储库服务器删除存储库。
    不会从数据库后端删除数据，而是会断开，
    因此将无法再进行访问。
    （以后可以重新连接数据，请参阅 'cm ^repository ^add'。）

示例：

    cm ^repository ^delete myrepository@^repserver:myserver:8084
    cm ^repository ^rm myrepository@myserver:8084
    cm ^repo ^rm myrepository

== CMD_DESCRIPTION_REPOSITORY_LIST ==
列出服务器上的存储库。

== CMD_USAGE_REPOSITORY_LIST ==
用法：

    cm ^repository | ^repo [^list | ^ls] [<存储库服务器规格>] [--^format=<格式字符串>]

选项：

    存储库服务器规格       存储库服务器规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        服务器规格。）
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。

== CMD_HELP_REPOSITORY_LIST ==
备注：

    此命令接受格式字符串以显示输出。

    此命令的输出参数如下：

        {^repid}     | {0}           存储库标识符。
        {^repname}   | {1}           存储库名称。
        {^repserver} | {2}           服务器名称。
        {^repowner}  | {3}           存储库所有者。
        {^repguid}   | {4}           存储库的唯一标识符。
        {^tab}                       插入一个制表符空格位。
        {^newline}                   插入一个新行。

    如果格式参数值为 '^TABLE'，则会使用具有 {^repid}、
    {^repname} 和 {^repserver} 字段的表格式来打印输出。

示例：

    cm ^repository
    （列出所有存储库。）

    cm ^repository ^list localhost:8084 --^format="{1, -20} {3}"
    （将存储库名称写入 20 个空格位，左对齐，然后留一个空白，
    再然后是存储库所有者。）

    cm ^repository ^ls localhost:8084 --^format="{^repname, -20} {^repowner}"
    （写入方式与前一个示例相同。）

    cm ^repo ^ls localhost:8084 --^format=^TABLE
    （使用具有以下字段的表格式来写入存储库列表：
    存储库 ID、存储库名称和存储库服务器名称。）

== CMD_DESCRIPTION_REPOSITORY_RENAME ==
重命名存储库。

== CMD_USAGE_REPOSITORY_RENAME ==
用法：

    cm ^repository | ^repo ^rename [<存储库规格>] <新名称>

    存储库规格             要重命名的存储库。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        规格。）
    新名称            存储库的新名称。

== CMD_HELP_REPOSITORY_RENAME ==
备注：

    此命令将重命名存储库。
    如果未指定存储库规格，则会采用当前存储库。

示例：

    cm ^repository ^rename development
    （将当前存储库重命名为 'development'。）

    cm ^repo ^rename ^rep:default@SERVER:8084 development
    （将 'SERVER' 上的 'default' 存储库重命名为 'development'。）

== CMD_DESCRIPTION_REPOSITORY_ADD ==
通过添加现有存储库的数据库来连接此存储库。

== CMD_USAGE_REPOSITORY_ADD ==
用法：

    cm ^repository | ^repo ^add <数据库文件> <存储库名称> <存储库服务器规格>

    数据库文件             数据库后端上的数据库文件的名称。
    存储库名称            存储库的名称。
    存储库服务器规格       存储库服务器规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        服务器规格。）

== CMD_HELP_REPOSITORY_ADD ==
备注：

    将现有存储库数据库重新连接到服务器。
    示例：使用 'cm ^repository ^delete' 命令后，使用 '^add' 命令
    将存储库从一个服务器移动到另一个服务器或还原
    已存档的存储库。

示例：

    cm ^repository ^add rep_27 myrepository myserver:8084

== CMD_DESCRIPTION_TRIGGER_CREATE ==
在服务器上创建新触发器。

== CMD_USAGE_TRIGGER_CREATE ==
用法：

    cm ^trigger | ^tr ^create | ^mk <子类型-类型> <新名称> <脚本路径>
                                [--^position=<新位置>]
                                [--^filter=<筛选器字符串>]
                                [--^server=<存储库服务器规格>]

    子类型-类型        触发器执行和触发器操作。
                        键入 'cm ^showtriggertypes' 可查看触发器类型
                        列表。
    新名称            新触发器的名称。
    脚本路径         服务器上包含要执行的脚本的
                        磁盘路径。如果命令行以 "^webtrigger " 开头，
                        则认为此触发器是 Web 触发器。请参阅
                        “备注”以了解更多信息。

选项：

    --^position          指定触发器的新位置。
                        此位置不能正在由相同类型的另一个
                        触发器使用。
    --^filter            仅检查与指定筛选器匹配的项。
    --^server            在指定服务器上创建触发器。
                        如果未指定服务器，则在客户端上配置的
                        服务器上执行命令。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        服务器规格。）

== CMD_HELP_TRIGGER_CREATE ==
备注：

    Web 触发器：创建 Web 触发器的方法是键入 "^webtrigger <目标-URI>"
    作为触发器命令。在这种情况下，触发器将针对指定的 URI
    执行 POST 查询，其中，请求主体包含带有触发器
    环境变量的 JSON 字典，还有一个指向字符串数组的
    固定 INPUT 键。

示例：

    cm ^trigger ^create ^after-setselector "BackupMgr" "/path/to/script" --^position=4

    cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084

    cm ^tr ^mk ^after-mklabel Log "/path/to/script" --^filter="^rep:myRep,LB*"
    （仅当标签名称以 'LB' 开头并且标签是在名为 'myRep' 的
    存储库中创建时，才会执行此触发器。）

    cm ^tr ^mk ^after-checkin NotifyTeam "^webtrigger http://myserver.org/api"

== CMD_DESCRIPTION_MOVE ==
移动或重命名文件或目录。

== CMD_USAGE_MOVE ==
用法：

    cm ^move | ^mv <源路径> <目标路径> [--^format=<格式字符串>]
                 [--^errorformat=<格式字符串>]

    源路径            源项的路径。
    目标路径            目标项的路径。

选项：

    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^errorformat       检索特定格式的错误消息。请参阅
                        “备注”以了解更多信息。

== CMD_HELP_MOVE ==
备注：

    此命令将移动或重命名存储库中的项。
    还会在本地文件系统中进行更改。

    如果源路径是文件，则目标路径可以是文件或
    目录。在第一种情况下会重命名文件；否则会移动
    相应的项。
    如果源路径是目录，则目标路径必须是目录。

    要移动或重命名的项必须已存在。

    格式：
        {0}         源路径（'--^format' 和 '--^errorformat'）
        {1}         目标路径（'--^format' 和 '--^errorformat'）

示例：

    cm ^move file.txt file.old
    （重命名相应的项。）

    cm ^mv .\file.old .\oldFiles
    （将 'file.old' 移到 'oldFiles'。）

    cm ^move .\src .\src2
    （重命名目录。）

== CMD_DESCRIPTION_LABEL ==
允许用户管理标签。

== CMD_USAGE_LABEL ==
用法：

    cm ^label | ^lb <命令> [选项]

命令：

    ^create | ^mk
    ^delete | ^rm
    ^rename

    要获取有关每条命令的更多信息，请运行：
    cm ^label <命令> --^usage
    cm ^label <命令> --^help

== CMD_HELP_LABEL ==
示例：

    cm ^label myNewLabel ^cs:42
    （'^create' 命令是可选命令。）
    
    cm ^label ^rename myNewLabel newLabelName
    cm ^label ^delete newLabelName

== CMD_DESCRIPTION_LABEL_CREATE ==
将标签应用于变更集，并在需要时创建标签。

== CMD_USAGE_LABEL_CREATE ==
用法：

    cm ^label [^create] <标签规格> [<变更集规格> | <工作区路径>]
                        [--^allxlinkedrepositories]
                        [-^c=<注释字符串> | -^commentsfile=<注释文件>]

    标签规格              新标签名称。
                        （使用 'cm ^help ^objectspec' 可进一步了解标签
                        规格。）
    变更集规格            要标记的变更集的名称或完整规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）
    工作区路径             要标记的工作区的路径。（工作区指向的
                        变更集将被标记。）

选项：

    --^allxlinkedrepositories  在所有通过 Xlink 链接的存储库中创建新标签。
    -^c                        将指定的注释应用于新标签。
    -^commentsfile             将指定文件中的注释应用于
                              新标签。

== CMD_HELP_LABEL_CREATE ==
备注：

    设置 PLASTICEDITOR 环境变量可指定用于键入注释的
    编辑器。

示例：

    cm ^label ^create ^lb:BL001 ^cs:1203 -^commentsfile=commentlb001.txt
    （创建附加到变更集 1203 的标签 'BL001'，并应用 'commentlb001.txt'
    文件中的注释。）

    cm ^label BL002 ^cs:1203 -^c="首次发布"
    （创建带有注释的标签 'BL002'，并附加到变更集 1203。）

== CMD_DESCRIPTION_LABEL_DELETE ==
删除一个或多个标签。

== CMD_USAGE_LABEL_DELETE ==
用法：

    cm ^label ^delete <标签规格>[ ...]

    标签规格          要删除的标签。使用空格对各个标签进行分隔。
                    （使用 'cm ^help ^objectspec' 可进一步了解标签
                    规格。）

== CMD_HELP_LABEL_DELETE ==
备注：

    此命令将删除一个或多个标签。

示例：

    cm ^label ^delete ^lb:BL001
    （删除标签 'BL001'。）

    cm ^label ^delete ^lb:BL001 ^lb:BL002@reptest@server2:8084
    （删除标签 'BL001' 和 'BL002'。）

== CMD_DESCRIPTION_LABEL_RENAME ==
重命名标签。

== CMD_USAGE_LABEL_RENAME ==
用法：

    cm ^label ^rename <标签规格> <新名称>

    标签规格          要重命名的标签。
                    （使用 'cm ^help ^objectspec' 可进一步了解标签规格。）
    新名称        标签的新名称。

== CMD_HELP_LABEL_RENAME ==
备注：

    此命令将重命名标签。

示例：

    cm ^label ^rename ^lb:BL001 BL002
    （将标签 'BL001' 重命名为 'BL002'。）

== CMD_DESCRIPTION_OBLITERATE ==
已弃用

== CMD_USAGE_OBLITERATE ==
已弃用。

== CMD_HELP_OBLITERATE ==
已弃用。

== CMD_DESCRIPTION_OBJECTSPEC ==
描述如何编写对象规格。

== CMD_USAGE_OBJECTSPEC ==
用法：
    cm ^objectspec
    获取关于如何构建对象规格的所有信息。

== CMD_HELP_OBJECTSPEC ==
一些 Plastic SCM 命令要求将 '对象规格' 作为输入来引用
给定对象（通常是分支、变更集、存储库等）。

本文档介绍可用的不同“规格”以及如何
构建规格。

每个规格类型以唯一标记（例如 "^rep:" 或 "^cs:"）开头。必须为
采用一般对象规格的命令指定标记（例如：
"cm ^setowner 对象规格" 命令），但对于仅采用单一类型规格的命令
常常可以省略标记（例如："cm ^getfile 修订规格" 命令）。

-- 存储库服务器规格 --
    ^repserver:name:port

    示例：
        cm ^repo ^list ^repserver:skull:8084
        cm ^repo ^list skull:8084

    旁注：
        由于历史原因，我们称之为“存储库服务器规格”，而不只是
        “服务器规格”。很久以前，我们有单独的工作区服务器和
        存储库服务器，命名方式沿用至今。

-- 存储库规格 --
    ^rep:rep_name@[存储库服务器规格]

    示例：
        cm ^showowner ^rep:codice@localhost:6060
        （此处的 "^rep:" 是必需的，因为 ^showowner 不仅容许存储库，
        而且容许其他类型的对象。因此，需要用户指明
         对象类型。）

-- 分支规格 --
    ^br:[/]br_name[@repspec]

    示例：
        cm ^switch ^br:/main@^rep:plastic@^repserver:skull:9095
        （这种情况下不需要 "^br:"、"^rep" 和 "^repserver"，所以
         该命令容许简短很多的格式：
        "cm ^switch main@plastic@skull:9095"。）

        cm ^find ^revisions "^where ^branch='^br:/main/task001'"

    备注：
        分支上的初始 '/' 不是必需的。我们曾经将所有分支
        指定为 /main、/main/task001，依此类推。但是现在，我们首选
        更短的 main、main/task001 形式，这使命令更简洁。

-- 变更集规格 --
    ^cs:cs_number|cs_GUID[@repspec]

    可以指定变更集的编号或 GUID。

    示例：
        cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070

-- 标签规格 --
    ^lb:lb_name[@repspec]

    示例：
        cm ^switch ^lb:RELEASE2.0
        cm ^switch ^lb:RELEASE1.4@myrep@MYSERVER:8084

-- 修订规格 --
有不同类型的修订规格：

    ^rev:item_path[#(分支规格|变更集规格|标签规格)]

    ^rev:^serverpath:item_path#(分支规格|变更集规格|标签规格)

    ^rev:^revid:rev_id[@rep_spec]

    ^rev:^itemid:item_id#(分支规格|变更集规格|标签规格)

    示例：
        cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20

        cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
            ^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084

        cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084

-- 项规格 --
    ^item:path
    极少使用。

    示例：
        cm ^find ^revision "^where ^item='^item:.'"

-- 属性规格 --
    ^att:att_name[@repspec]

    示例：
        cm ^attribute ^set ^att:merged@code@doe:8084 ^cs:25@code@doe:8084 完成

-- 搁置规格 --
    ^sh:sh_number[@repspec]

    示例：
        cm ^diff ^sh:2 ^sh:4

-- 工作区规格 --
    ^wk:name@clientmachine

极少使用，因为仅适用于工作区相关的命令。适合用于
按名称和机器（而不是路径）来指定工作区。

    示例：
        cm ^showselector ^wk:codebase@modok

    旁注：
        这些规格来自早期的 Plastic SCM 2.x，当时的
        “工作区服务器”是一种集中存储工作区元数据
        的方式。后期由于性能问题而被弃用。

== CMD_DESCRIPTION_PARTIAL ==
在非完整的工作区中运行命令。

== CMD_USAGE_PARTIAL ==
用法：

    cm ^partial <命令> [选项]

命令：

    ^configure
    ^add
    ^undo
    ^co   | ^checkout
    ^unco | ^undocheckout
    ^ci   | ^checkin
    ^mv   | ^move
    ^rm   | ^remove
    ^stb  | ^switch
    ^upd  | ^update

    要获取有关每条命令的更多信息，请运行：
    cm ^partial <命令> --^usage
    cm ^partial <命令> --^help

== CMD_HELP_PARTIAL ==
示例：

    cm ^partial ^configure +/background-blue.png
    cm ^partial ^update landscape-1024.png
    cm ^partial ^checkin eyes-green.png eyes-black.png

== CMD_DESCRIPTION_PARTIAL_ADD ==
向版本控制中添加项。

== CMD_USAGE_PARTIAL_ADD ==
用法：

    cm ^partial ^add [-^R | -^r | --^recursive] [--^silent] [--^parents]
                   [--^ignorefailed] [--^skipcontentcheck] <项路径>[ ...]

    项路径           要添加的项。使用双引号 (" ") 指定包含空格
                        的路径。使用空格对各个路径进行分隔。
                        使用 * 添加当前目录的所有内容。

选项：

    -^R                  以递归方式添加项。
    --^silent            不显示任何输出。
    --^parents           在操作中包含指定项
                        的父目录。
    --^ignorefailed      如果无法添加某一项，则添加操作将在没有
                        这一项的情况下继续进行。注意：如果无法添加
                        某个目录，则不会添加目录中的内容。
    --^skipcontentcheck  如果不足以根据扩展名将文件设置为
                        文本或二进制，默认情况下会将该文件设置为二进制，
                        而不是检查内容来检测类型。

== CMD_HELP_PARTIAL_ADD ==
备注：

    添加项的要求：
    - 要添加的项的父目录必须已事先添加。

示例：

    cm ^partial ^add pic1.png pic2.png
    （添加 'pic1.png' 和 'pic2.png' 项。）

    cm ^partial ^add c:\workspace\picture.png
    （添加路径 'c:\workspace' 中的 'picture.png' 项。）

    cm ^partial ^add -^R c:\workspace\src
    （以递归方式添加 'src'。）
    
    cm ^partial ^add --^parents samples\design01.png
    （添加 'design01.png' 文件和 'samples' 父文件夹。）
    
    cm ^partial ^add -^R *
    （以递归方式添加当前目录的所有内容。）

== CMD_DESCRIPTION_PARTIAL_CHECKIN ==
将更改存储在存储库中。

== CMD_USAGE_PARTIAL_CHECKIN ==
用法：

    cm ^partial ^checkin | ^ci [<项路径>[ ...]]
                            [-^c=<注释字符串> | -^commentsfile=<注释文件>]
                            [--^all | -^a] [--^applychanged] [--^keeplock]
                            [--^symlink] [--^ignorefailed]

选项：

    项路径           要签入的项。使用双引号 (" ") 指定
                        包含空格的路径。使用空格对各个路径进行
                        分隔。
                        使用 . 将签入应用到当前目录。
    -^c                  指定在签入操作中创建的变更集
                        的注释。
    -^commentsfile       将指定文件中的注释应用于在签入操作中
                        创建的变更集。
    --^all | -^a          还包括在指定路径上进行了本地更改、移动
                        和删除的项。
    --^applychanged      将签入操作应用于在工作区中
                        检测到的已更改项以及
                        签出的项。
    --^keeplock          签入操作后保持锁定项的
                        锁定状态。
    --^symlink           将签入操作应用于符号链接而不是
                        目标。
    --^ignorefailed      无法应用的任何更改（因为无法获得
                        锁定状态（又称为“独占签出”）或者
                        因为本地更改与服务器更改冲突）
                        将被丢弃，然后没有这些更改的情况下
                        继续进行签入操作。

== CMD_HELP_PARTIAL_CHECKIN ==
备注：

    - 如果未指定 <项路径>，则签入操作将涉及
      工作区中的所有待定更改。
    - 签入操作始终以递归方式从给定路径应用。
    - 要签入项，必须满足以下条件：
    - 项必须受源代码管理。
    - 必须签出项。
    - 如果已更改但未签出项，则除非 <项路径> 是目录
      或包含通配符 ('*')，否则不需要
      '--^applychanged' 标志。

    修订内容必须与以前的修订不同才能
    签入。

    设置 PLASTICEDITOR 环境变量可指定用于键入注释的
    编辑器。

从 stdin 读取输入：

    '^partial ^checkin' 命令可从 stdin 读取路径。为此，请传递
    一个破折号 "-"。
    示例：cm ^partial ^checkin -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要签入的文件。
    示例：
      dir /S /B *.c | cm ^partial ^checkin --^all -
      （在 Windows 中，签入工作区中的所有 .c 文件。）

示例：

    cm ^partial ^checkin figure.png landscape.png
    （将签入应用于已签出的文件 'figure.png' 和 'landscape.png'。）

    cm ^partial ^checkin .-^commentsfile=mycomment.txt
    （将签入应用于当前目录并设置 'mycomment.txt' 文件
    中的注释。）

    cm ^partial ^ci background.png -^c="我的注释" --^keeplock
    （将签入应用于 'background.png'，包含注释，并保持
    锁定。）

    cm ^partial ^checkin --^applychanged
    （将签入应用于工作区中的所有待定更改。）
    
    cm ^partial ^checkin 链接 --^symlink
    （将签入应用于链接文件而非目标，适用于
    UNIX 环境。）

    cm ^partial ^checkin .--^ignorefailed
    （将签入应用于当前目录，忽略无法应用的
    更改。）

== CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
将文件标记为修改就绪。

== CMD_USAGE_PARTIAL_CHECKOUT ==
用法：

    cm ^partial ^checkout | ^co [<项路径>[ ...]] [--^resultformat=<格式字符串>]
                             [--^silent] [--^ignorefailed]

选项：

    项路径           要签出的项。使用双引号 (" ") 指定
                        包含空格的路径。使用空格对各个路径进行
                        分隔。
                        使用 . 将签出应用到当前目录。
    --^resultformat      检索特定格式的输出结果
                        消息。
    --^silent            不显示任何输出。
    --^ignorefailed      如果无法锁定某项（无法执行独占签出），
                        则签出操作将在没有这一项的情况下
                        继续进行。

== CMD_HELP_PARTIAL_CHECKOUT ==
备注：

    要签出项，必须满足以下条件：
    - 项必须受源代码管理。
    - 必须签入项。
        
    如果在服务器上配置了锁（存在 lock.conf），则每次
    在某条路径上进行签出时，Plastic 都会检查是否符合规则，
    如果符合，该路径将处于独占签出（锁定）状态，以便任何其他人
    都无法同时进行签出。
    可使用 'cm ^lock ^list' 获取服务器中的所有锁。
    请查看《管理员指南》以了解锁定的工作原理：
    https://www.plasticscm.com/download/help/locking

示例：

    cm ^partial ^checkout pic1.png pic2.png
    （签出 'pic1.png' 和 'pic2.png' 文件。）
    
    cm ^partial ^co *.png
    （签出所有 png 文件。）

    cm ^partial ^checkout .
    （签出当前目录。）
    
    cm ^partial ^checkout -^R c:\workspace\src
    （以递归方式签出 'src' 文件夹。）

== CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
可以通过在工作区中加载或卸载项来配置工作区。

== CMD_USAGE_PARTIAL_CONFIGURE ==
用法：

    cm ^partial ^configure <+|-路径>[ ...][--^silent] [--^ignorefailed]
                         [--^ignorecase] [--^restorefulldirs]

    路径           要加载或卸载的路径。使用双引号 (" ")
                   指定包含空格的路径。使用空格对各个路径进行
                   分隔。
                   路径必须以 "/" 开头。

选项：

    --^silent            不显示任何输出。
    --^ignorefailed      跳过该过程中的所有错误。错误路径
                        不会导致命令停止。
    --^ignorecase        忽略路径中的大小写。使用此标志后，
                        即使用户写入 "/data/teXtures"，'^configure' 也对
                        "/Data/Textures" 有效。
    --^restorefulldirs   重置无效的目录配置（在非完整的工作区上
                        运行完整操作时发生）。
                        此列表中的目录将实现完全配置
                        （完全检查），这意味着这些目录将在
                        更新期间自动下载新内容。
                        此操作不会下载任何文件，只会
                        在非完整的工作区上还原目录
                        配置。

== CMD_HELP_PARTIAL_CONFIGURE ==
备注：

    该命令采用递归操作。

示例：

    cm ^partial ^configure +/landscape_grey.png
    （加载 'landscape_grey.png' 项。）

    cm ^partial ^configure -/landscape_black.png
    （卸载 'landscape_black.png' 项。）

    cm ^partial ^configure +/soft -/soft/soft-black.png
    （加载除 'soft-black.png' 以外的所有 'soft' 目录子项。）

    cm ^partial ^configure -/
    （卸载整个工作区。）

    cm ^partial ^configure -/ +/
    （加载整个工作区。）

    cm ^partial ^configure -/figure-64.png --^ignorefailed
    （即使已卸载 'figure-64.png' 项，也要卸载该项。）
    
    cm ^partial ^configure +/ --^restorefulldirs
    （设置所有目录来自动下载新内容。）
    
    cm ^partial ^configure +/src/lib --^restorefulldirs
    （仅设置 '/src/lib' 及其子目录来自动下载
    新内容。）

== CMD_DESCRIPTION_PARTIAL_MOVE ==
移动或重命名文件或目录。

== CMD_USAGE_PARTIAL_MOVE ==
用法：

    cm ^partial ^move | ^mv <源路径> <目标路径> [--^format=<格式字符串>]

    源路径            源项的路径。
    目标路径            目标项的路径。

选项：

    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。

== CMD_HELP_PARTIAL_MOVE ==
备注：

    此命令将移动或重命名存储库中的项。
    还会在本地文件系统中进行更改。
    
    如果源路径是文件，则目标路径可以是文件或
    目录。在第一种情况下将重命名文件；否则将移动
    相应的项。
    如果源路径是目录，则目标路径必须是目录。

    要移动或重命名的项必须已存在。

    格式：
        {0}             源路径。
        {1}             目标路径。

示例：

    cm ^partial ^move file.png file-blue.png
    （重命名相应的项。）

    cm ^partial ^mv .\file-blue.png .\blueFiles
    （将 'file-blue.png' 移动到 'blueFiles'。）

    cm ^partial ^move .\design .\marketing
    （重命名目录。）

== CMD_DESCRIPTION_PARTIAL_RM ==
从版本控制中删除一个文件或目录。

== CMD_USAGE_PARTIAL_RM ==
用法：

    cm ^partial ^remove | ^rm <项路径>[ ...][--^nodisk]

    项路径       要删除的项路径。使用双引号 (" ")
                    指定包含空格的路径。使用空格对各个路径进行
                    分隔。

选项：

    --^nodisk        从版本控制中删除相应的项，但是将该项保留在磁盘上。

== CMD_HELP_PARTIAL_RM ==
备注：

    磁盘中会删除项。删除的项会从源代码管理
    中的父目录中被删除。

    要求：
    - 项必须受源代码管理。

示例：

    cm ^partial ^remove src
    （删除 'src'。如果 'src' 是目录，则等同于：
    cm ^partial ^remove -^R src。）

    cm ^partial ^remove c:\workspace\pic01.png --^nodisk
    （从版本控制中删除 'pic01.png'，但将其保留在磁盘上。）

== CMD_DESCRIPTION_PARTIAL_SWITCH ==
将分支设置为工作分支。

== CMD_USAGE_PARTIAL_SWITCH ==
用法：

    cm ^switch <分支规格> [--^report | --^silent] [--^workspace=<路径>]
    （设置工作分支并更新工作区。）

    cm ^switch <分支规格> --^configure <+|-路径>[ ...][--^silent]
                            [--^ignorefailed] [--^ignorecase] [--^workspace=<路径>]
    （设置工作分支并运行工作区配置，就像 'cm
    ^partial ^configure' 命令一样。）

    分支规格         分支的规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解分支规格。）
    路径                要加载或卸载的路径。使用双引号 (" ")
                        指定包含空格的路径。使用空格对各个路径
                        进行分隔。路径必须以 "/" 开头。

选项：

    --^silent            不显示任何输出。
    --^report            命令完成后，打印已应用更改
                        的列表。使用 '--^silent' 将会覆盖此设置。
                        此选项仅在未指定 '--^configure' 选项
                        时有效。
    --^configure         更新工作分支后配置
                        （加载/卸载项）工作区。查看 'cm ^partial
                        ^configure --^help' 可了解如何指定要配置的
                        路径。
    --^ignorefailed      跳过配置过程中的所有错误。
                        错误路径不会导致命令停止。
    --^ignorecase        忽略路径中的大小写。使用此标志后，即使
                        用户写入 "/data/teXtures"，选项 '--^configure' 也对
                        "/Data/Textures" 有效。
    --^workspace=路径    工作区所在的路径。

== CMD_HELP_PARTIAL_SWITCH ==
备注：

    此命令允许用户更新工作分支。更新分支之后，
    该命令就像 'cm ^partial ^update' 命令一样会
    将工作区更新到新分支。然而，如果指定了 '--^configure'
    选项，该命令就像 'cm ^partial ^configure' 命令一样会
    允许使用新的分支配置来配置工作区。

示例：

    cm ^switch ^br:/main/task
    （将 /main/task 设置为工作分支并更新工作区。）

    cm ^switch ^br:/main/task --^configure +/art/images
    （将 /main/task 设置为工作分支，并配置工作区来
    加载 /art/images 文件夹。）

== CMD_DESCRIPTION_PARTIAL_UNCO ==
撤销项的签出。

== CMD_USAGE_PARTIAL_UNCO ==
用法：

    cm ^partial ^undocheckout | ^unco <项路径>[ ...][--^silent]

    项路径           要应用操作的项。使用双引号 (" ")
                        指定包含空格的路径。使用空格对各个路径
                        进行分隔。
                        使用 . 将操作应用到当前目录。

选项：

    --^silent            不显示任何输出。

== CMD_HELP_PARTIAL_UNCO ==
备注：

    如果已签出某个项并且不想将这个项签入，则可以
    使用此命令撤销签出。文件和文件夹都可以取消
    签出。项将更新为签出之前的状态。

    要求：
      - 项必须受源代码管理。
      - 必须签出项。

示例：

    cm ^partial ^undocheckout .
    （撤销当前目录中的签出。）

    cm ^partial ^undocheckout pic1.png pic2.png
    cm ^unco c:\workspace\design01.png
    （撤销签出所选文件。）

== CMD_DESCRIPTION_PARTIAL_UNDO ==
撤销工作区中的更改。

== CMD_USAGE_PARTIAL_UNDO ==
用法：

    cm ^partial ^undo [<路径>[ ...]] [--^symlink] [-^r | --^recursive]
                    [<筛选器>[ ...]]
                    [--^silent | --^machinereadable [--^startlineseparator=<分隔符>]
                                [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

    路径                    要应用操作的文件或目录
                            的路径。使用双引号 (" ") 指定
                            包含空格的路径。使用空格对各个路径
                            进行分隔。
                            如果未指定路径，则默认情况下，
                            撤销操作将应用于当前目录中的所有
                            文件。
    筛选器                  将一个或多个指定筛选器应用于给定
                            路径。使用空格对各个筛选器进行分隔。请参阅
                            “筛选器”部分以了解更多信息。

选项：

    --^symlink               将撤销操作应用于符号链接而不是
                            目标。
    -^r                      以递归方式执行撤销。
    --^silent                不显示任何输出。
    --^machinereadable       以易于解析的格式输出结果。
    --^startlineseparator    与 '--^machinereadable' 标志结合使用，指定
                            行应如何开头。
    --^endlineseparator      与 '--^machinereadable' 标志结合使用，指定
                            行应如何结尾。
    --^fieldseparator        与 '--^machinereadable' 标志结合使用，指定
                            应如何分隔字段。

筛选器：

    如果未指定标志，则默认情况下将撤销所有更改，但是
    可以使用以下一个或多个标志来筛选路径。
    如果文件或目录匹配一个或多个指定种类的更改，
    则将撤销该文件或目录上的所有更改。
    例如，如果同时指定了 '--^checkedout' 和 '--^moved'，则在
    已签出并移动文件的情况下，两项更改都将被撤销。

    --^checkedout            选择已签出的文件和目录。
    --^unchanged             选择内容不变的文件。
    --^changed               选择本地更改的或签出的文件和
                            目录。
    --^deleted               选择已删除的文件和目录。
    --^moved                 选择已移动的文件和目录。
    --^added                 选择已添加的文件和目录。

== CMD_HELP_PARTIAL_UNDO ==
备注：

    ^undo 命令有风险，因为该命令在撤销工作后将不可逆。
    ^undo 完成后，无法将受其影响的文件和目录
    恢复到先前状态。如果参数中
    未指定路径，则默认情况下，该命令将撤销
    当前目录中的所有更改，但不采用递归方式。
    从 /src 目录执行时，以下命令是等效的：

        /src
        |- file.txt
        |- code.cs
        \- /test
           |- test_a.py
           \- test_b.py

        cm ^partial ^undo
        cm ^partial ^undo *
        cm ^partial ^undo file.txt code.cs /test

        cm ^partial ^undo .
        cm ^partial ^undo /src file.txt code.cs

    如果希望操作以递归方式执行，必须指定 '-^r' 标志。

    撤销某一目录下的所有更改（包括影响目录
    本身的更改）：

        cm ^partial ^undo 目录路径 -^r

    如果目录路径是工作区路径，则工作区中的每个更改都将
    被撤销。

示例：

    cm ^partial ^undo .-^r
    （以递归方式撤销当前目录中的所有更改。如果从工作区的
    根目录执行，则撤销整个工作区中的所有更改。）

    cm ^partial ^co file.txt
    cm ^partial ^undo file.txt
    （撤销对 file.txt 的签出。）

    ^echo ^content >> file.txt
    cm ^partial ^undo file.txt
    （撤销对 file.txt 的本地更改。）

    cm ^partial ^undo src
    （撤销对 src 目录及其文件的更改。）

    cm ^partial ^undo src/*
    （撤销对 src 中包含的每个文件和目录的更改，而不会
    影响 src。）

    cm ^partial ^undo *.cs
    （撤销对当前目录中与 *.cs 匹配的每个文件或目录的
    更改。）

    cm ^partial ^undo *.cs-^r
    （撤销对当前目录以及下级每个目录中与 *.cs 匹配的
    每个文件或目录的更改。）

    cm ^partial ^co file1.txt file2.txt
    ^echo ^content >> file1.txt
    cm ^partial ^undo --^unchanged
    （撤销对未更改的 file2.txt 的签出，并忽略本地更改的
    file1.txt。）

    ^echo ^content >> file1.txt
    ^echo ^content >> file2.txt
    cm ^partial ^co file1.txt
    cm ^partial ^undo --^checkedout
    （撤销已签出文件 file1.txt 中的更改，并忽略 file2.txt，
    因为后者未签出。）

    cm ^partial ^add file.txt
    cm ^partial ^undo file.txt
    （撤销添加 file.txt，使该文件再次成为私有文件。）

    ^rm file1.txt
    ^echo ^content >> file2.txt
    cm ^partial ^add file3.txt
    cm ^partial ^undo --^deleted --^added *
    （撤销 file1.txt 的删除和 file3.txt 的添加，并忽略 file2.txt
    的更改。）

== CMD_DESCRIPTION_PARTIAL_UPDATE ==
更新非完整的工作区并下载最新的更改。

== CMD_USAGE_PARTIAL_UPDATE ==
用法：

    cm ^partial ^update [<项路径>[ ...]] [--^changeset=<编号>]
                      [--^silent | --^report] [--^dontmerge]

    项路径           要更新的项。使用双引号 (" ") 指定
                        包含空格的路径。使用空格对各个路径进行
                        分隔。
                        使用 . 将更新应用到当前目录。
                        如果未指定路径，则当前非完整的
                        工作区将完全更新。

选项：

    --^changeset         将非完整的工作区更新到特定变更集。
    --^silent            不显示任何输出。
    --^report            命令完成后，打印已应用更改
                        的列表。使用 '--^silent' 将会覆盖此设置。
    --^dontmerge         不合并文件冲突，只是跳过这些冲突。
                        其他更改会正确应用。此选项可用于
                        自动化，从而避免用户交互。


== CMD_HELP_PARTIAL_UPDATE ==
备注：

    '^partial ^update' 命令将更新已过期的文件。

    该命令采用递归操作。

    在使用 '--^changeset' 选项时，如果所有指定的路径都是
    同一 Xlink 内的文件，则会在通过 Xlink 链接的存储库的
    指定变更集内搜索要下载的版本。

示例：

    cm ^partial ^update
    （更新当前非完整的工作区中的所有内容。）

    cm ^partial ^update .
    （更新所有当前目录子项。）

    cm ^partial ^update backgroud-blue.png
    （更新 'backgroud-blue.png' 项。）

    cm ^partial ^update soft_black.png soft-grey.png
    （更新 'soft_black.png' 和 'soft-grey.png' 项。）

    cm ^partial ^update src --^report
    （更新所有 'src' 目录子项，并在最后打印已应用的
    更改列表。）

    cm ^partial ^update src --^changeset=4
    （将所有 'src' 目录子项更新为变更集 4 中
    加载的相应内容。）

    cm ^partial ^update xlink/first.png --^changeset=4
    （将 'xlink/first.png' 项更新为通过 Xlink 链接的存储库的变更集 4 中
    加载的相应内容。）

== CMD_DESCRIPTION_PATCH ==
从规格生成一个补丁文件，或者将生成的补丁应用于当前
工作区。

== CMD_USAGE_PATCH ==
用法：

    cm ^patch <源规格> [<源规格>] [--^output=<输出文件>]
             [--^tool=<差异比较路径>]
    生成一个补丁文件，该文件包含分支的差异差、
    变更集的差异差或变更集之间的差异。还用于跟踪
    文本文件和二进制文件的差异。

    cm ^patch --^apply <补丁文件> [--^tool=<修补路径>]
    允许应用当前工作区中生成的补丁文件的
    内容。

    源规格     变更集或分支的完整规格。（使用
                    'cm ^help ^objectspec' 可进一步了解规格。）
    输出文件     用于保存补丁内容的文件。如果未指定文件，
                    则会在标准输出中打印补丁内容。
    补丁文件      要在当前工作区中应用的补丁文件。

选项：

    --^output        设置 patch 命令的输出文件。
    --^tool          设置要使用的应用程序（差异比较还是修补）。

== CMD_HELP_PATCH ==
限制：

    如果输出补丁文件已经存在，该命令不会覆盖这个文件。

    应用补丁时，如果磁盘上没有已修改的文件，该命令不会
    将更改应用于这些文件。

重要信息：

    此命令需要差异比较工具和修补工具；可从以下网址公开获得这些工具：
    http://gnuwin32.sourceforge.net/packages/patch.htm 和
    http://gnuwin32.sourceforge.net/packages/diffutils.htm

    安装后，建议将工具的位置添加到 PATH
    环境变量。

示例：

    cm ^patch ^cs:4@default@localhost:8084
    （以统一格式在控制台上打印变更集 4 的差异。）

    cm ^patch ^br:/main --^output=file.patch
    （使用分支 "main" 的差异来生成补丁文件。）

    cm ^patch ^br:/main --^output=file.patch --^tool=C:\gnu\diff.exe
    （同上，使用的是自定义执行程序。）

    cm ^patch ^cs:2@default ^cs:4@default
    （以统一格式在控制台上打印变更集 2 和 4 之间的差异。）

    cm ^patch --^apply file.patch --^tool=C:\gnu\patch.exe
    （使用自定义执行程序将 'file.patch' 中的补丁应用于本地工作区。）

== CMD_DESCRIPTION_QUERY ==
执行 SQL 查询。需要 SQL 存储。

== CMD_USAGE_QUERY ==
用法：

    cm ^query <SQL_命令> [--^outputfile=<输出文件>]
                           [--^solveuser=<列名称>[,...]]
                           [--^solvepath=<列名称>[,...]]
                           [--^columnwidth=<值>] [--^nocolumnname]
                           [--^columnseparator=<分隔符>] [--^repository=<名称>]

    SQL_命令         要执行的 SQL 查询。

选项：

    --^outputfile        将结果写入输出文件中。
    --^solveuser         将指定的列设置为用户名列。查询
                        解释器将假定这些列的数据将是用户，
                        并将尝试解析这些数据。
    --^solvepath         将指定的列设置为 itemid 列。查询
                        解释器将尝试将项 ID 解析为文件系统
                        路径。
    --^columnwidth       指定每列的宽度以便格式化输出。
    --^nocolumnname      不打印列名称。
    --^columnseparator   使用字符作为列分隔符，而不是使用制表符 (\t)。
    --^repository        要查询的存储库。

== CMD_HELP_QUERY ==
备注：

    此命令允许用户在服务器数据库中执行 SQL 查询。

    为了编写 SQL 查询，请使用以下两个预定义的函数来管理
    用户和路径：
    - '^SolveUser(<用户名>)'，将用户名解析为 Plastic SCM 格式。
    - '^SolvePath(<路径>)'，将磁盘路径解析为项 ID。

    此外，还可使用选项以便于人工阅读的形式显示查询结果。

    可以使用选项 '--^solveuser=<列名称>' 和
    '--^solvepath=<列名称>' 来指定必须由查询解释器
    转换为易读文本的列。可以指定多个列名称，
    以逗号分隔。

示例：

    cm ^query "^SELECT * ^FROM ^revision" --^columnwidth=25 --^repository=reptest
    （从存储库 'reptest' 中的 '修订' 表检索数据。）

    cm ^query "^SELECT b.^sname ^as 分支名称, o.^dtimestamp ^as 日期 ^from ^branch b, \
        ^object o, ^seid s ^where b.^iobjid=o.^iobjid ^and o.^fidowner=s.^iseidid ^and \
        s.^scode='^SolveUser(john)'" --^outputfile=query.txt
    （将所有者为 'john' 的分支输出到文件中。）

    cm ^query "^select r.^iobjid, r.^fiditem ^as 路径, s.^scode ^as 用户名 ^FROM \
        ^revision r, ^object o, ^seid s ^WHERE r.^iobjid=o.^iobjid ^and \
        o.^fidowner=s.^iseidid ^and o.^dtimestamp>2014/04/25" \
    --^solveuser=用户名 --^solvepath=路径 --^repository=reptest@server2:9095
    （从所选存储库检索选定数据。）

    cm ^query "^SELECT * ^FROM ^revision ^WHERE ^fiditem=^SolvePath(c:\mywkpath\info)"
    （检索路径 'info' 的所有修订数据。）

== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
删除一个或多个属性。

== CMD_USAGE_ATTRIBUTE_DELETE ==
用法：

    cm ^attribute | ^att ^delete | ^rm <属性规格>[ ...]

    属性规格            要删除的属性。使用空格对各个属性进行
                        分隔。
                        （使用 'cm ^help ^objectspec' 可进一步了解属性
                        规格。）

== CMD_HELP_ATTRIBUTE_DELETE ==
备注：

    此命令将删除一个或多个属性。

示例：

    cm ^attribute ^delete ^att:status
    （删除属性 '状态'。）

    cm ^att ^rm 状态 ^att:integrated@reptest@server2:8084
    （删除属性 '状态' 和 '集成'。）

== CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
取消设置对象的属性。

== CMD_USAGE_ATTRIBUTE_UNSET ==
用法：

    cm ^attribute | ^att ^unset <属性规格> <对象规格>

    属性规格            属性的规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解属性规格。）
    对象规格         要删除相应属性的对象
                        的规格。可以在以下对象上设置属性：分支、变更集、
                        搁置集、标签、项和修订。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）

== CMD_HELP_ATTRIBUTE_UNSET ==
备注：

    该命令将取消设置先前在对象上设置的某个属性。该命令
    不会删除属性对象本身。

示例：

    cm ^attribute ^unset ^att:status ^br:/main/SCM105
    （从分支 'main/SCM105' 删除属性实现 '状态'。）

    cm ^att ^unset ^att:integrated@reptest@localhost:8084 ^cs:25@reptest@localhost:8084
    （从变更集 25 删除属性实现 '集成'，全都在
    存储库 'reptest' 中。）

== CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
为属性重命名。

== CMD_USAGE_ATTRIBUTE_RENAME ==
用法：

    cm ^attribute | ^att ^rename <属性规格> <新名称>

    属性规格            要重命名的属性。（使用 'cm ^help ^objectspec' 可
                        进一步了解属性规格。）
    新名称            属性的新名称。

== CMD_HELP_ATTRIBUTE_RENAME ==
备注：

    此命令将重命名一个属性。

示例：

    cm ^attribute ^rename ^att:status state
    （将属性 '状态' 重命名为 '状况'。）

== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
编辑属性的注释。

== CMD_USAGE_ATTRIBUTE_EDIT ==
用法：

    cm ^attribute | ^att ^edit <属性规格> <新注释>

    属性规格        要更改相应注释的属性。（使用 'cm ^help ^objectspec'
                    可进一步了解属性规格。）
    新注释     属性的新注释。还可以为属性指定
                    一个默认值列表。

== CMD_HELP_ATTRIBUTE_EDIT ==
备注：

    此命令将更改属性的注释。

    要指定属性的默认值列表，只需将
    如下的行包含在属性注释中：
    'default: 值_一, "值二", 值3, "最终值"'。

示例：

    cm ^attribute ^edit ^att:status "CI 管道中分支的状态。"
    （编辑属性 '状态' 的注释。）

    cm ^attribute ^edit ^att:status "分支的状态。默认值：未完成、已解决、已审查"
    （编辑属性 '状态' 的注释。还指定一个值
    列表。因此，当属性 '状态' 设置为对象时，可以选择
    以下值之一："未完成"、"已解决" 或 "已审查"。）

== CMD_DESCRIPTION_REPLICATE ==
警告：已弃用此命令。

请使用 'cm ^pull'（等同于 '^replicate'）和 'cm ^push'（等同于
'^replicate --^push'）。

== CMD_USAGE_REPLICATE ==

== CMD_HELP_REPLICATE ==

== CMD_DESCRIPTION_PULL ==
从另一个存储库拉取分支。

== CMD_USAGE_PULL ==
用法：

    cm ^pull <源分支规格> <目标存储库规格>
            [--^preview] [--^nodata] [转换选项]
            [--^user=<用户名> [--^password=<密码>] | 身份验证选项]
     （服务器之间的直接复制。从存储库拉取分支。）

    cm ^pull <目标存储库规格> --^package=<包文件> [身份验证选项]
     （基于包的复制。将包导入目标存储库中。）

    cm ^pull ^hydrate <目标分支规格> [<源存储库规格>]
                    [--^user=<用户名> [--^password=<密码>] | 身份验证选项]
     （为分支中先前使用 '--^nodata' 复制的所有变更集
     引入缺失的数据。如果未指定用于获取数据的存储库，
     Plastic 会尝试使用“复制源”（复制分支
     的来源））。

    cm ^pull ^hydrate <目标变更集规格> [<源存储库规格>]
                    [--^user=<用户名> [--^password=<密码>] | 身份验证选项]
     （为先前使用 '--^nodata' 复制的变更集引入缺失的
     数据。如果未指定用于获取数据的存储库，Plastic 会尝试
     使用“复制源”）。

    源分支规格     要从远程存储库拉取的分支。
                    （使用 'cm ^help ^objectspec' 可进一步了解分支规格。）
    目标分支规格     要进行 hydrate 的分支。
                    （使用 'cm ^help ^objectspec' 可进一步了解分支规格。）
    目标变更集规格     要进行 hydrate 的变更集。
                    （使用 'cm ^help ^objectspec' 可进一步了解变更集
                    规格。）
    目标存储库规格    目标存储库。
                    （使用 'cm ^help ^objectspec' 可进一步了解存储库
                    规格。）
    --^package       指定要导入的先前创建的包文件以进行
                    基于包的复制。
                    适合在没有直接网络连接时用于在服务器
                    之间移动数据。
                    请参阅 'cm ^push' 以创建包文件。

选项：

    --^preview           提供关于将拉取哪些更改的信息，
                        但实际上不进行任何更改。此选项
                        可用于检查在复制更改之前要传输
                        的数据。
    --^nodata            复制分支更改而不复制
                        数据。复制包时，不允许使用
                        此选项。
    转换选项    请参阅“转换选项”部分以了解更多信息。
    --^user, --^password  源和目标的身份验证模式不同并且
                        没有可用于目标身份验证的配置文件
                        的情况下使用的凭据。
    身份验证选项         请参阅“身份验证选项”部分以了解更多
                        信息。

转换选项：

    --^trmode=(^copy|^name|^table --^trtable=<转换表文件>)
      源和目标存储库可能使用不同的身份验证
      模式。'--^trmode' 选项指定如何将用户名从源
      转换到目标。'--^trmode' 必须为以下值
      之一：
          ^copy    （默认值）。表示只会复制用户标识符。
          ^name    按名称来匹配用户标识符。
          ^table   使用选项 '--^trtable' 中指定的转换表
                  （见下文）。

    --^trtable=<转换表文件>
        如果转换模式为 'table'，则转换表文件中包含
        格式为 <旧名称;新名称> 的行（每行一个）。将分支
        写入目标存储库时，源存储库中由“旧名称”
        标识的用户所创建的对象将设置到目标上
        具有“新名称”的用户。

身份验证选项：

    可以使用以下两种模式之一来指定身份验证数据：

    1) 使用身份验证参数：--^authmode=<模式> --^authdata=<数据>

        --^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
        示例：
        (^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
        (^UPWorkingMode)   --^authdata=dave:fPBea2rPsQaagEW3pKNveA==

        '--^authdata' 行是 client.conf 文件和 profiles.conf 文件
        中的 <^SecurityConfig> 条目的内容。可以从
        Plastic GUI 中的“首选项”下的“复制配置文件”选项卡
        轻松生成 profiles.conf 文件。

        如果使用 ^UPWorkingMode，则只需指定：

        --^authmode=^UPWorkingMode --^user=<用户> --^password=<密码>

    2) 身份验证文件，对于连接到的每个服务器，文件可能会
       有所不同，其中包含该服务器的凭据。

        --^authfile=<身份验证文件>
            该文件包含 2 行：
            第 1 行是模式，如 '--^authmode' 中所述
            第 2 行是身份验证数据，如 '--^authdata' 中所述

== CMD_HELP_PULL ==
备注：

    '^pull' 命令可以在源存储库与目标存储库之间
    复制分支（以及这些分支的变更集）。
    这些存储库可以位于不同服务器中。

    有两种复制操作：'^push' 和 '^pull'。

    '^pull' 操作表示复制操作要求将数据从源存储库
    存储到目标存储库。
    客户端将连接到目标存储库，然后建立
    从该主机到源存储库的连接以便检索
    目标数据。在拉取期间，目标服务器将
    连接到源。

    尽管在典型的分布式场景中，开发者会将数据
    从本地服务器推送到主服务器，但开发者可能也希望
    从主服务器拉取最新的存储库更新。

    复制操作可以解决在同一分支上两个复制的存储库
    已进行并发更改的情况：

    - 推送：如果尝试将数据推送到一个存储库，但这个存储库中的
      更改比发送的更改更新，则系统会要求提取最新的更改，
      解决合并操作问题，最后尝试再次推送。

    - 拉取：每次从远程分支拉取变更集时，都会将这些变更集
      正确链接到相应的父变更集。如果拉取的变更集不是
      分支中最后一个变更集的子级，则会出现
      一种多头场景。该分支将具有多个“头部”，即分支中的
      最后一个变更集。此时需要先合并两个“头部”，
      然后才能再次推送。

    可以按两种模式进行拉取：

    1) 服务器之间的直接通信：目标服务器将
       从源服务器提取数据，自动为指定
       分支同步数据。

    2) 使用推送和 '--^package' 选项来导入先前生成的包。

    模式 1) 要求远程服务器对运行命令的用户进行身份验证，
    方法是使用 client.conf 文件中的默认身份验证，
    或者指定 '--^authmode' 和 '--^authdata' 修饰符
    或 '--^authmode'、'--^user' 和 '--^password'（如果身份验证模式为
    ^UPWorkingMode）。

    模式 2) 要求使用先前通过推送命令生成的
    包文件。

    请记住，拉取复制是以间接方式进行的。执行时，
    该命令要求目标存储库连接到源
    并获取所选分支。

    然而，可以使用推送命令来直接实现这一点。
    因此，该命令会将所选分支从源复制到
    目标。

示例：

    cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084
    （将 'main' 分支从 'remoteserver' 拉取到 'myserver'。这种情况下，
    两个服务器会配置为相同的身份验证模式。）

    cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
      --^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
    （拉取与以前相同的分支，但现在将远程服务器配置为
    使用 Active Directory 对用户进行身份验证。例如，我正在从 Linux
    计算机连接到配置为使用 Active Directory 集成模式
    的 Windows 服务器。我会指定自己的 Active Directory 用户名和密码，
    并以 LDAP 形式将此信息传递给服务器。）

    cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
      --^authmode=^UPWorkingMode --^user=dave --^password=mysecret
    （拉取同一个分支，但现在利用 Plastic SCM 中
    包含的用户名/密码数据库在远程服务器上对用户
    进行身份验证。）

    cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 --^nodata
    （将 'main' 分支从 'remoteserver' 复制到 'myserver' 而不复制数据。）

    cm ^pull ^hydrate ^br:/main@projectx@myserver:8084 projectx@remoteserver:8084
    （从远程服务器获取数据，对 'main' 分支中的所有变更集
    进行 hydrate 操作。）

    cm ^pull ^hydrate ^cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
    （从远程服务器获取数据，对 'myserver' 中的变更集 122169 进行
    hydrate 操作。）

== CMD_DESCRIPTION_PUSH ==
将分支推送到另一个存储库。

== CMD_USAGE_PUSH ==
用法：

    cm ^push <源分支规格> <目标存储库规格>
            [--^preview] [转换选项]
            [--^user=<用户名> [--^password=<密码>] | 身份验证选项]
     （服务器之间的直接复制。从存储库推送分支。）

    cm ^push <源分支规格> --^package=<包文件> [身份验证选项]
     （基于包的复制。使用所选分支在源服务器中
     创建复制包。）

    源分支规格     要推送到远程存储库的分支。
                    （使用 'cm ^help ^objectspec' 可进一步了解分支规格。）
    目标存储库规格    目标存储库。
                    （使用 'cm ^help ^objectspec' 可进一步了解存储库
                    规格。）
    --^package       指定复制包的导出路径，从而进行
                    基于包的复制。
                    适合在没有直接网络连接时用于在服务器
                    之间移动数据。

选项：

    --^preview           提供关于将推送哪些更改的信息，
                        但实际上不进行任何更改。此选项
                        可用于检查在复制更改之前要传输
                        的数据。
    转换选项    请参阅“转换选项”部分以了解更多信息。
    --^user, --^password  源和目标的身份验证模式不同并且
                        没有可用于目标身份验证的配置文件
                        的情况下使用的凭据。
    身份验证选项         请参阅“身份验证选项”部分以了解更多
                        信息。

转换选项：

    --^trmode=(^copy|^name|^table --^trtable=<转换表文件>)
        源和目标存储库可能使用不同的身份验证
        模式。'--^trmode' 选项指定如何将用户名从源
        转换到目标。'--^trmode' 必须为以下值
        之一：
          ^copy    （默认值）。表示只会复制用户标识符。
          ^name    按名称来匹配用户标识符。
          ^table   使用选项 '--^trtable' 中指定的转换表
                  （见下文）。

    --^trtable=<转换表文件>
        如果转换模式为 'table'，则转换表文件中包含
        格式为 <旧名称;新名称> 的行（每行一个）。将分支
        写入目标存储库时，源存储库中由“旧名称”
        标识的用户所创建的对象将设置到目标上
        具有“新名称”的用户。

身份验证选项：

    可以使用以下两种模式之一来指定身份验证数据：

    1) 使用身份验证参数：--^authmode=<模式> --^authdata=<数据>

        --^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
        示例：
        (^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
        (^UPWorkingMode)   --^authdata=dave:fPBea2rPsQaagEW3pKNveA==

        '--^authdata' 行是 client.conf 文件和 profiles.conf 文件
        中的 <^SecurityConfig> 条目的内容。可以从
        Plastic GUI 中的“首选项”下的“复制配置文件”选项卡
        轻松生成 profiles.conf 文件。

        如果使用 ^UPWorkingMode，则只需指定：

        --^authmode=^UPWorkingMode --^user=<用户> --^password=<密码>

    2) 身份验证文件，对于连接到的每个服务器，文件可能会
       有所不同，其中包含该服务器的凭据。

        --^authfile=<身份验证文件>
            该文件包含 2 行：
            第 1 行是模式，如 '--^authmode' 中所述
            第 2 行是身份验证数据，如 '--^authdata' 中所述

== CMD_HELP_PUSH ==
备注：

    '^push' 命令可以在源存储库与目标存储库之间
    复制分支（以及这些分支的变更集）。
    这些存储库可以位于不同服务器中。

    有两种复制操作：'^push' 和 '^pull'。

    '^push' 操作表示复制操作会将数据从源存储库
    发送到目标存储库。在这种情况下，
    客户端将连接到源存储库，获取要复制的数据，
    然后将数据发送到目标存储库。虽然
    前者（源）必须与目标连接，但是后者（目标）
    本身不会连接到源。

    在典型的分布式场景中，开发者会将数据从本地服务器
    推送到主服务器。此外，开发者可能也希望从主服务器
    拉取最新的存储库更新。

    复制可以解决在两个复制存储库的同一分支上
    已进行并发更改的情况。

    - 推送：如果尝试将数据推送到一个存储库，但这个存储库中的
      更改比发送的更改更新，则系统会要求提取最新的更改，
      解决合并操作问题，最后尝试再次推送。

    - 拉取：每次从远程分支拉取变更集时，都会将这些变更集
      正确链接到相应的父变更集。如果拉取的变更集不是
      分支中最后一个变更集的子级，则会出现
      一种多头场景。该分支将具有多个“头部”，即分支中的
      最后一个变更集。此时需要先合并两个“头部”，
      然后才能再次推送。

    可以按两种模式进行推送：

    1) 服务器之间的直接通信：源服务器将
       把数据发送到目标服务器，自动为指定
       分支同步数据。

    2) 导出包模式：客户端将仅连接到源
       并获取指定分支的数据和元数据来生成一个
       复制包。此模式下将使用 '--^package' 修饰符。

    这两种模式都要求服务器对运行命令的用户进行身份验证，
    方法是使用 client.conf 文件中的默认身份验证，
    或者指定 '--^authmode' 和 '--^authdata' 修饰符。

    ^push 推送复制是以直接方式进行的。执行时，
    该命令将所选分支从源复制到目标
    （而不是要求目标存储库连接到源）并获取
    所选分支（与拉取操作一样）。

示例：

    cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084
    （将 'main' 分支从 'myserver' 复制到 'remoteserver'。这种情况下，
    两个服务器会配置为相同的身份验证模式。）

    cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
      --^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
    （复制与以前相同的分支，但现在将远程服务器配置为
    使用 Active Directory 对用户进行身份验证。例如，我正在从 Linux
    计算机连接到配置为使用 Active Directory 集成模式
    的 Windows 服务器。我会指定自己的 Active Directory 用户名和密码，
    并以 LDAP 形式将此信息传递给服务器。）

    cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
      --^authmode=^UPWorkingMode --^user=dave --^password=mysecret
    （复制同一个分支，但现在利用 Plastic SCM 中
    包含的用户名/密码数据库在远程服务器上对用户
    进行身份验证。）

== CMD_DESCRIPTION_CLONE ==
克隆远程存储库。

== CMD_USAGE_CLONE ==
用法：

    cm ^clone <源存储库规格> [<目标存储库规格> | <目标存储库服务器规格>]
             [--^user=<用户名> [--^password=<密码>] | 身份验证选项]
                [转换选项]
    （存储库之间的直接克隆。）

    cm ^clone <源存储库规格> --^package=<包文件>
             [--^user=<用户名> [--^password=<密码>] | 身份验证选项]
    （克隆到中间包，随后可以使用拉取操作将中间包
    导入到目标存储库。）

    源存储库规格        克隆操作的源存储库。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        规格。）
    目标存储库规格        克隆操作的目标存储库。如果
                        已存在，必须为空。如果不存在，
                        则会进行创建。
                        如果未指定，该命令将使用用户的
                        默认存储库服务器。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        规格。）
    目标存储库服务器规格  克隆操作的目标存储库服务器。
                        如果存在与目标存储库服务器中的
                        <源存储库规格> 同名的存储库，此存储库
                        必须为空。如果没有，则会进行创建。
                        如果未指定，该命令将使用用户的
                        默认存储库服务器。
                        （使用 'cm ^help ^objectspec' 可进一步了解存储库
                        服务器规格。）

选项：

    --^user, --^password  源和目标的身份验证模式不同并且
                        没有可用于目标身份验证的配置文件
                        的情况下使用的凭据。
    --^package           将指定的存储库导出到包文件，
                        而不是存储库。
                        适合在没有直接网络连接时用于在服务器
                        之间移动数据。
                        必须使用拉取命令来导入
                        生成的包。
    转换选项    请参阅“转换选项”部分以了解更多信息。
    身份验证选项         请参阅“身份验证选项”部分以了解更多
                        信息。

转换选项：
    --^trmode=(^copy|^name|^table --^trtable=<转换表文件>)
      源和目标存储库可能使用不同的身份验证
      模式。'--^trmode' 选项指定如何将用户名从源
      转换到目标。'--^trmode' 必须为以下值
      之一：
          ^copy    （默认值）。表示只会复制用户标识符。
          ^name    按名称来匹配用户标识符。
          ^table   使用选项 '--^trtable' 中指定的转换表
                  （见下文）。

    --^trtable=<转换表文件>
        如果转换模式为 'table'，则转换表文件中包含
        格式为 <旧名称;新名称> 的行（每行一个）。将分支
        写入目标存储库时，源存储库中由“旧名称”
        标识的用户所创建的对象将设置到目标上
        具有“新名称”的用户。

身份验证选项：

    可以使用以下两种模式之一来指定身份验证数据：

    1) 使用身份验证参数：--^authmode=<模式> --^authdata=<数据>

        --^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
        示例：
        (^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
        (^UPWorkingMode)   --^authdata=dave:fPBea2rPsQaagEW3pKNveA==

        '--^authdata' 行是 client.conf 文件和 profiles.conf 文件
        中的 <^SecurityConfig> 条目的内容。可以从
        Plastic GUI 中的“首选项”下的“复制配置文件”选项卡
        轻松生成 profiles.conf 文件。

        如果使用 ^UPWorkingMode，则只需指定：

        --^authmode=^UPWorkingMode --^user=<用户> --^password=<密码>

    2) 身份验证文件，对于连接到的每个服务器，文件可能会
       有所不同，其中包含该服务器的凭据。

        --^authfile=<身份验证文件>
            该文件包含 2 行：
            第 1 行是模式，如 '--^authmode' 中所述
            第 2 行是身份验证数据，如 '--^authdata' 中所述

== CMD_HELP_CLONE ==
备注：

    克隆命令可以将分支（以及这些分支的变更集、
    标签、属性、审查等）从源存储库复制到
    目标存储库。这些存储库可以位于不同服务器中。

    可以预先创建目标存储库，但是如果此存储库包含
    以前的数据，克隆操作会失败。

    克隆操作不会克隆存储库子模块，也不会克隆 Xlink 下的
    存储库。

示例：

    cm ^clone awesomeProject@tardis@cloud
    （将 'awesomeProject' 存储库从 'tardis@cloud' 组织
    克隆到同名的本地存储库。）

    cm ^clone repo@server.home:9095 repo-local
    （将 'repo' 从 'server.home:9095' 克隆到用户的默认存储库服务器
    中的 'repo-local'。）

    cm ^clone project@192.168.111.130:8084 ^repserver:192.168.111.200:9095
    （将 'project' 存储库从 '192.168.111.130:8084' 克隆到
    'project@192.168.111.200:9095'。）

    cm ^clone project@ldapserver:8084 --authfile=credentials.txt \
      --^trmode=table --^trtable=table.txt
    （从 'ldapserver:8084' 克隆 'project' 存储库，使用针对
    远程存储库的身份验证文件，并按照指定的
    转换表来转换用户。）

    cm ^clone project@server.home:9095 --^package=project.plasticpkg
    cm ^repository ^create project@mordor.home:8084
    cm ^pull --^package=project.plasticpkg project@mordor.home:8084
    （将 'project' 存储库从 'server.home:9095' 克隆到包
    'project.plasticpkg'，随后通过拉取操作将这个包导入到
    'mordor.home:8084' 的'project' 存储库。）

== CMD_DESCRIPTION_REVERT ==
将项还原到先前的修订。

== CMD_USAGE_REVERT ==
用法：

    cm ^revert <修订规格>

    修订规格             包含修订（修订的内容将加载到工作区中）
                        的变更集的规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解修订
                        规格。）

== CMD_HELP_REVERT ==
备注：

    必须签入项。

示例：

    cm ^revert dir#^cs:0
    cm ^revert C:\mywks\dir\file1.txt#23456

== CMD_DESCRIPTION_REVISION_HISTORY ==
显示文件或目录的历史记录。

== CMD_USAGE_REVISION_HISTORY ==
用法：

    cm ^history | ^hist <项路径>[ ...][--^long | --^format=<格式字符串>]
                      [--^symlink] [--^xml[=<输出文件>]] [--^encoding=<名称>]

    项路径           项的路径。使用空格对各个路径进行分隔。使用
                        双引号 (" ") 指定包含空格的路径。
                        路径也可以是服务器路径修订。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）

选项：

    --^long              显示其他信息。
    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。
    --^symlink           将历史记录操作应用于符号链接而不是
                        目标。
    --^xml               以 XML 格式将输出打印到标准输出。
                        可以指定输出文件。
    --^encoding          与 '--^xml' 选项结合使用，指定要在 XML 输出
                        中使用的编码（例如：utf-8）。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。

== CMD_HELP_REVISION_HISTORY ==
备注：

    此命令将显示给定项的修订列表，以及每个修订的标签、
    分支和注释信息。

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：
        {0} | {^date}              日期。
        {1} | {^changesetid}       变更集编号。
        {2} | {^branch}            分支。
        {4} | {^comment}           注释。
        {5} | {^owner}             所有者。
        {6} | {^id}                修订 ID。
        {7} | {^repository}        存储库。
        {8} | {^server}            服务器。
        {9} | {^repspec}           存储库规格。
        {^tab}                     插入一个制表符空格位。
        {^newline}                 插入一个新行。

示例：

    cm ^history file1.txt "file 2.txt"

    cm ^hist c:\workspace --^long
    （显示所有信息。）

    cm ^history 链接 --^symlink
    （将历史记录操作应用于 '链接' 文件而不是目标，
    适用于 UNIX 环境。）

    cm ^history ^serverpath:/src/foo/bar.c#^br:/main/task001@myserver
    （从给定分支中的服务器路径检索修订历史记录。）

== CMD_DESCRIPTION_REVISION_TREE ==
显示项的修订树。

== CMD_USAGE_REVISION_TREE ==
用法：

    cm ^tree <路径> [--^symlink]

    路径        项路径。

选项：

    --^symlink   将操作应用于链接文件而不是目标。

== CMD_HELP_REVISION_TREE ==
示例：

    cm ^tree fichero1.txt
    cm ^tree c:\workspace
    cm ^tree 链接 --^symlink
    （将操作应用于链接文件而不是目标；适用于
    UNIX 环境。）

== CMD_DESCRIPTION_RM ==
允许用户删除文件和目录。

== CMD_USAGE_RM ==
用法：

    cm ^remove | ^rm <命令> [选项]

命令：

    ^controlled（可选）
    ^private

    要获取有关每条命令的更多信息，请运行：
    cm ^remove <命令> --^usage
    cm ^remove <命令> --^help

== CMD_HELP_RM ==
示例：

    cm ^remove \path\controlled_file.txt
    cm ^remove ^private \path\private_file.txt

== CMD_DESCRIPTION_RM_CONTROLLED ==
从版本控制中删除一个文件或目录。

== CMD_USAGE_RM_CONTROLLED ==
用法：

    cm ^remove | ^rm <项路径>[ ...][--^format=<格式字符串>]
                   [--^errorformat=<格式字符串>] [--^nodisk]

    项路径           要删除的项路径。使用双引号 (" ") 指定
                        包含空格的路径。使用空格对各个路径进行
                        分隔。

选项：

    --^format            检索特定格式的输出进度
                        消息。请参阅“示例”以了解更多信息。
    --^errorformat       检索特定格式的错误消息
                        （如果有）。请参阅“示例”以了解更多信息。
    --^nodisk            从版本控制中删除相应的项，但是将该项保留在
                        磁盘上。

== CMD_HELP_RM_CONTROLLED ==
备注：

    磁盘中会删除项。删除的项会从源代码管理
    中的父目录中被删除。

    要求：
    - 项必须受源代码管理。

从 stdin 读取输入：

    '^remove' 命令可从 stdin 读取路径。为此，请传递一个
    破折号 "-"。
    示例：cm ^remove -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要删除的文件。
    示例：
      dir /S /B *.c | cm ^remove -
      （在 Windows 中，删除工作区中的所有 .c 文件。）

示例：

    cm ^remove src
    （删除 'src'。如果 src 是目录，则等同于
    'cm ^remove -^R src'。）

    cm ^remove c:\workspace\file.txt --^format="{0} - 已删除" \
        --^errorformat="{0} - 删除时出错"
    （从版本控制中和磁盘上删除 'file.txt'，
    如果操作成功，则写入 "c:\workspace\file.txt - ^REMOVED"，
    否则写入 "c:\workspace\file.txt - ^ERROR ^REMOVING"。）

    cm ^remove c:\workspace\file.txt --^nodisk
    （从版本控制中删除 'file.txt'，但将其保留在磁盘上。）

== CMD_DESCRIPTION_RM_PRIVATE ==
删除一个私有文件或目录。

警告：使用该命令删除的文件将被永久擦除而无法
恢复。建议使用 '--^dry-run' 选项来检查
哪些文件将受到该命令的影响。

== CMD_USAGE_RM_PRIVATE ==
用法：

    cm ^remove | ^rm ^private <路径>[ ...][-^R | -^r | --^recursive] [--^ignored]
                           [--^verbose] [--^dry-run]

    路径                要删除的文件或目录的路径。使用双
                        引号 (" ") 指定包含空格的路径。使用
                        空格对各个路径进行分隔。

选项：

    --^r                 以递归方式从受控目录内删除私有
                        文件。
    --^ignored           还删除已忽略和掩蔽的文件和目录。
    --^verbose           打印所有受影响的路径。
    --^dry-run           运行此命令而不在磁盘上进行任何更改。

== CMD_HELP_RM_PRIVATE ==
备注：

    如果路径是私有文件或目录，则会从磁盘上将其删除。
    如果路径是受控文件，该命令会失败。
    如果路径是受控目录，则除非指定 '-^r' 选项
    ，否则该命令将失败，在这种情况下，它将删除指定目录下的
    所有私有文件和目录。

示例：

    cm ^remove ^private private_directory
    （删除 'private_directory'。）

    cm ^remove ^private c:\workspace\controlled_directory
    （失败，因为 'controlled_directory' 并非私有目录。）

    cm ^remove ^private -^r c:\workspace\controlled_directory
    （删除 'controlled_directory' 下的所有私有文件和目录。）

    cm ^rm ^private --^dry-run --^verbose c:\workspace\controlled_directory -^r
    （显示 'controlled_directory' 下的私有文件被删除所影响的
    所有路径，实际上不删除任何内容。）

    cm ^rm ^private --^verbose c:\workspace\controlled_directory -^r
    （显示 'controlled_directory' 下的私有文件被删除所影响的
    所有路径，并执行删除。）

== CMD_DESCRIPTION_TRIGGER_DELETE ==
删除触发器。

== CMD_USAGE_TRIGGER_DELETE ==
用法：

    cm ^trigger | ^tr ^delete | ^rm <子类型-类型> <位置编号>
                                [--^server=<存储库服务器规格>]

    子类型-类型        触发器执行和触发器操作。
                        键入 'cm ^showtriggertypes' 可查看触发器类型
                        列表。
    位置编号     创建触发器时分配给触发器的位置。

选项：

    --^server            删除指定服务器上的触发器。
                        如果未指定服务器，则在客户端上配置的
                        服务器上执行命令。

== CMD_HELP_TRIGGER_DELETE ==
示例：

    cm ^trigger ^delete ^after-setselector 4
    cm ^tr ^rm ^after-setselector 4

== CMD_DESCRIPTION_ATTRIBUTE_SET ==
在给定对象上设置属性。

== CMD_USAGE_ATTRIBUTE_SET ==
用法：

    cm ^attribute | ^att ^set <属性规格> <对象规格> <属性值>

    属性规格           属性的规格。（使用 'cm ^help ^objectspec' 可
                       进一步了解属性规格。）
    对象规格        要设置相应属性的对象的规格。
                       可以在以下对象上设置属性：分支、变更集、
                       搁置集、标签、项和修订。
                       （使用 'cm ^help ^objectspec' 可进一步了解规格。）
    属性值          要为对象设置的属性值。

== CMD_HELP_ATTRIBUTE_SET ==
备注：

    可以在一个对象上设置属性来保存此对象的
    其他信息。
    可以在以下对象上设置属性：分支、变更集、
    搁置集、标签、项和修订。

示例：

    cm ^attribute ^set ^att:status ^br:/main/SCM105 未完成
    （将属性 '状态' 设置为分支 'SCM105'，值为 '未完成'。）

    cm ^att ^set ^att:integrated@reptest@server2:8084 ^lb:LB008@reptest@server2:8084 是
    （在存储库 'reptest' 中将属性 '集成' 设置为标签 'LB008'，
    值为 '是'。）

== CMD_DESCRIPTION_SETOWNER ==
设置对象的所有者。

== CMD_USAGE_SETOWNER ==
用法：

    cm ^setowner | ^sto --^user=<用户名> | --^group=<组> <对象规格>

    --^user              用户名。对象的新所有者。
    --^group             组名称。对象的新所有者。
    对象规格         要设置新所有者的对象的规格。
                        可以在以下对象上设置所有者：
                        存储库服务器、存储库、分支、变更集、
                        标签、项、修订和属性。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）

== CMD_HELP_SETOWNER ==
备注：

    对象的所有者可以是用户或组。

    可以在以下对象上设置所有者：存储库服务器、
    存储库、分支、变更集、标签、项、修订和属性。

示例：

    cm ^setowner --^user=john ^repserver:localhost:8084
    （将 'john' 设置为存储库服务器所有者。）

    cm ^sto --^group=development ^rep:mainRep@PlasticServer:8084
    （将 'development' 组设置为 'mainRep' 存储库的所有者。）

== CMD_DESCRIPTION_SETSELECTOR ==
将选择器设置为工作区。

== CMD_USAGE_SETSELECTOR ==
已弃用此命令。为了向后兼容，此命令仍然存在，
但是在 Plastic SCM 4.0 中，已在很大程度上弃用选择器。仍然存在的选择器
是为了指定工作分支或变更集，但不再支持
用于筛选路径的旧规则。

用法：
    cm ^setselector | ^sts [--^file=<选择器文件>] [--^ignorechanges]
                         [--^forcedetailedprogress] [<工作区路径> | <工作区规格>]

选项：

    --^file                   要从中加载选择器的文件。
    --^ignorechanges          忽略在更新工作区时
                             检测到待定更改的情况下显示
                             的待定更改警告消息。
    --^forcedetailedprogress  即使在标准输出被重定向的情况下也要强制显示
                             详细进度。
    工作区路径                  用于设置选择器的工作区的路径。
    工作区规格                  工作区的规格。（使用 'cm ^help ^objectspec'
                             可进一步了解工作区规格。）

== CMD_HELP_SETSELECTOR ==
备注：

    此命令将设置工作区的选择器。

    工作区需要某些信息才能从存储库加载修订。
    为了获得这些信息，Plastic SCM 需要使用选择器。

    通过使用选择器，可以从给定的分支、标签或
    变更集加载修订。

    如果未指定用于加载选择器的文件，则将执行默认的
    操作系统编辑器。

    示例选择器：

    ^repository "^default" // 工作存储库
      ^path "/"           // 规则将应用于根目录
        ^branch "/^main"   // 从 ^br:/^main 获取最新修订
        ^checkout "/^main" // 将签出内容放在 ^br:/^main 分支中

示例：

    cm ^sts
    （打开要应用的当前选择器文件。）

    cm ^sts ^wk:workspace_projA@reptest
    （打开要应用的指定选择器文件。）

    cm ^setselector --^file=c:\selectors\sel.xml
    （在当前工作区中设置指定的选择器文件。）

    cm ^setselector --^file=c:\selectors\sel.xml ^wk:MyWorkspace
    （在选定工作区中设置指定的选择器文件。）

== CMD_DESCRIPTION_SHELVE ==
搁置已签出项的内容。

== CMD_USAGE_SHELVE ==
已弃用此命令。请改用 'cm ^shelveset'。

用法：

    cm ^shelve [<项路径>+] [--^all] [--^dependencies]
              [-^c=注释字符串 | -^commentsfile=<注释文件>]
              [--^encoding=名称] [--^comparisonmethod=比较方法]
    （搁置内容。）

    cm ^shelve --^apply=<搁置规格> [--^mount]
    （应用存储的搁置集。）

    --^apply             还原指定搁置集的已搁置内容。
                        搁置规格：查看 'cm ^help ^objectspec'。

    cm ^shelve --^delete=<搁置规格>
    （删除存储的搁置集。）

    --^delete            删除指定的搁置集。
                        搁置集规格：查看 'cm ^help ^objectspec'。

选项：

    项路径           要搁置的项（以空格分隔）。可以使用引号 (")
                        来指定包含空格的路径。
    --^all               还包括在给定路径上进行了本地更改、
                        移动和删除的项。
    --^dependencies      在要搁置的项中包含本地更改
                        依赖项。
    -^c                  将指定的注释应用于创建的搁置集。
    -^commentsfile       将指定文件中的注释应用于创建的
                        搁置集。
    --^encoding          指定输出编码，如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。
    --^comparisonmethod  设置比较方法。请参阅“备注”以了解更多信息。
    --^mount             给定存储库的装入点。

== CMD_HELP_SHELVE ==

备注：

    如果既没有指定 <项路径>，也没有指定任何其他选项，则搁置将涉及
    工作区中的所有待定更改。

    搁置操作始终以递归方式从给定路径应用。

    搁置项的要求：
    - 项必须受源代码管理。
    - 必须签出或更改项（必须使用 --^all 选项）。

    比较方法：
        ^ignoreeol               忽略行尾差异。
        ^ignorewhitespaces       忽略空格差异。
        ^ignoreeolwhitespaces    忽略行尾和空格差异。
        ^notignore               检测行尾和空格差异。

    设置 PLASTICEDITOR 环境变量可指定用于键入注释的
    编辑器。

示例：

    cm ^shelve -^c="我的注释"
    （搁置当前工作区中的所有待定更改，包括
    注释。）

    cm ^shelve file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
    （搁置选定的待定更改并应用 commentshelve.txt
    文件中的注释。）

    cm ^shelve --^apply=^sh:3
    （应用存储的搁置集。）

    cm ^shelve --^delete=^sh:3
    （删除存储的搁置集。）

    cm ^status --^short --^changelist=pending_to_review | cm ^shelve -
    （搁置客户端更改列表。
    以上命令将列出名为 'pending_to_review'
    的更改列表中的路径，并且路径列表将重定向到
    shelve 命令的输入。）

== CMD_DESCRIPTION_SHELVESET ==
允许用户管理搁置集。

== CMD_USAGE_SHELVESET ==
用法：

    cm ^shelveset <命令> [选项]

命令：

    ^create | ^mk
    ^delete | ^rm
    ^apply

    要获取有关每条命令的更多信息，请运行：
    cm ^shelveset <命令> --^usage
    cm ^shelveset <命令> --^help

== CMD_HELP_SHELVESET ==
示例：

    cm ^shelveset ^create -^c="我的注释"
    cm ^shelveset ^delete ^sh:3
    cm ^shelve ^apply ^sh:3

== CMD_DESCRIPTION_SHELVESET_CREATE ==
搁置待定更改。

== CMD_USAGE_SHELVESET_CREATE ==
用法：

    cm ^shelveset ^create | ^mk [<项路径>[ ...]] [--^all] [--^dependencies]
                             [-^c=<注释字符串> | -^commentsfile=<注释文件>]

选项：

    项路径           要搁置的项。使用空格对各个用户名进行分隔。
                        使用双引号 (" ") 指定包含空格的
                        路径。
    --^all               还包括在给定路径上进行了本地更改、
                        移动和删除的项。
    --^dependencies      在要搁置的项中包含本地更改
                        依赖项。
    -^c                  将指定的注释应用于创建的搁置。
    -^commentsfile       将指定文件中的注释应用于创建的
                        搁置。

== CMD_HELP_SHELVESET_CREATE ==
'^shelveset ^create' 命令可将已签出项的内容存储在
    存储库中。这样，无需签入文件便可以
    保护内容。

备注：

    如果既没有指定 <项路径>，也没有指定任何其他选项，则搁置集将
    包含工作区中的所有待定更改。

    '^shelveset ^create' 操作始终从给定路径以递归方式
    应用。

    搁置项的要求：
    - 项必须受源代码管理。
    - 必须签出或更改项（必须使用 '--^all' 选项）。

    设置 PLASTICEDITOR 环境变量可指定用于键入注释的
    编辑器。

示例：

    cm ^shelveset ^create -^c="我的注释"
    （搁置当前工作区中的所有待定更改，包括
    注释。）

    cm ^shelveset file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
    （搁置选定的待定更改并应用 'commentshelve.txt'
    文件中的注释。注意，'^create' 是默认的子命令。）

    cm ^status --^short --^changelist=pending_to_review | cm ^shelveset -
    （搁置客户端更改列表。
    以上命令将列出名为 'pending_to_review'
    的更改列表中的路径，并且路径列表将重定向到
    '^shelveset' 命令的输入。）

== CMD_DESCRIPTION_SHELVESET_DELETE ==
删除搁置集。

== CMD_USAGE_SHELVESET_DELETE ==
用法：

    cm ^shelveset ^delete | ^rm <搁置规格>
    
    搁置规格             搁置集规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解搁置集规格。）

== CMD_HELP_SHELVESET_DELETE ==
'^shelveset ^delete' 命令可删除搁置集。

示例：

    cm ^shelveset ^delete ^sh:3
    （删除存储的搁置集。）

== CMD_DESCRIPTION_SHELVESET_APPLY ==
应用存储的搁置集。

== CMD_USAGE_SHELVESET_APPLY ==
用法：

    cm ^shelveset ^apply <搁置规格> [--^mount] [--^encoding=<名称>]
                       [--^comparisonmethod=(^ignoreeol | ^ignorewhitespaces| \
                                            ^ignoreeolwhitespaces | ^notignore)]

    搁置规格             搁置集规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解搁置集规格。）

选项：

    --^mount             给定存储库的装入点。
    --^encoding          指定输出编码，如：utf-8。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。
    --^comparisonmethod  设置比较方法。请参阅“备注”以了解更多信息。

== CMD_HELP_SHELVESET_APPLY ==
'^shelveset ^apply' 命令可还原存储的搁置集的内容。

备注：

    比较方法：
        ^ignoreeol               忽略行尾差异。
        ^ignorewhitespaces       忽略空格差异。
        ^ignoreeolwhitespaces    忽略行尾和空格差异。
        ^notignore               检测行尾和空格差异。

示例：

    cm ^shelveset ^apply ^sh:3
    （应用存储的搁置。）

== CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
列出对象和属性。

== CMD_USAGE_SHOW_FIND_OBJECTS ==
用法：

    cm ^showfindobjects

== CMD_HELP_SHOW_FIND_OBJECTS ==
可用对象和属性：

^attribute:
    可以通过使用以下字段进行筛选来查找属性：

    ^type    ：字符串。

              示例：
                  cm ^find ^attribute "^where ^type = '状态'"
                  （查找 '状态' 类型的所有属性。）

    ^value   ：字符串。
    ^date    ：日期。
              请在本指南中查看“日期常量”以了解更多信息。

              示例：
                  cm ^find ^attribute "^where ^date > '^this ^week'"
                  （查找本周内应用的所有属性。）

    ^owner   ：用户。
              容许特殊用户 '^me'。

              示例：
                  cm ^find ^attribute "^where ^value = '已解决' ^and ^owner = '^me'"
                  （查找具有 '已解决' 值并由我应用的所有属性。）

    ^GUID    ：全局唯一标识符。
              十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^comment ：字符串。
    ^srcobj  ：对象规格：项路径、分支、变更集、修订或标签。
              使用 'cm ^help ^objectspec' 可了解如何指定这些对象。

              示例：
                  cm ^find ^attribute "^where ^srcobj = '^item:readme.txt'"
                  （查找应用于项 'readme.txt' 的属性。）

                  cm ^find ^attribute "^where ^srcobj = '^br:/main/scm23343'"
                  （查找应用于分支 scm23343 的属性。）

                  cm ^find ^attribute "^where ^srcobj = '^rev:readme.txt#^br:/main/task002'"
                  （查找应用于指定修订的属性。）

                  cm ^find ^attribute "^where ^srcobj = '^rev:^revid:1126'"
                  （查找应用于指定修订 ID 的属性。）

    ^ID      ：整数。

^attributetype:
    可以通过使用以下字段进行筛选来查找属性类型：

    ^name    ：字符串。

              示例：
                  cm ^find ^attributetype "^where ^name ^like 'st%'"
                  （查找名称以 'st' 开头的所有属性。）

    ^value   ：字符串。
    ^date    ：日期。
              请在本指南中查看“日期常量”以了解更多信息。

              示例：
                  cm ^find ^attribute "^where ^date > '^today'"
                  （查找今天应用的所有属性。）

    ^owner   ：用户。
              容许特殊用户 '^me'。
    ^GUID    ：全局唯一标识符。
              十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^comment ：字符串。

              示例：
                  cm ^find ^attributetype "^where ^comment != ''" --^xml
                  （查找具有某个注释的所有属性类型，并且以 XML 格式
                  将输出打印到标准输出。）

    ^source  ：对象规格：项路径、分支、变更集或标签。
              使用 'cm ^help ^objectspec' 可了解如何指定这些对象。

              示例：

                  cm ^find ^attributetype "^where ^source = '^item:readme.txt'"
                  （查找项 'readme.txt' 中的所有属性类型。）

                  cm ^find ^attributetype "^where ^source = '^cs:30'"
                  （查找变更集 '30' 中的所有属性类型。）

                  cm ^find ^attributetype "^where ^source = '^lb:v0.14.1'"
                  （查找标签 'v0.14.1' 中的所有属性类型。）

    ^ID      ：整数。

    复制字段。查看下文的“与复制相关的字段”。
        ^ReplLogId
        ^ReplSrcDate
        ^ReplSrcId
        ^ReplSrcRepository
        ^ReplSrcServer

^branch:
    可以通过使用以下字段进行筛选来查找分支：

    ^name       ：字符串。

                 示例：
                    cm ^find ^branch "^where ^name ^like 'scm23%'"
                    （查找名称以 'scm23' 开头的分支。）

    ^date       ：日期。
                 请在本指南中查看“日期常量”以了解更多信息。

                 示例：
                    cm ^find ^branch "^where ^date > '^one ^week ^ago'"
                    （查找上周创建的分支。）

    ^changesets ：日期（分支中变更集的日期）。
                 请在本指南中查看“日期常量”以了解更多信息。

                 示例：
                    cm ^find ^branch "^where ^changesets >= '^today'"
                    （查找包含今天创建的变更集的分支。）

    ^attribute  ：字符串。
    ^attrvalue  ：字符串。

                 示例：
                    cm ^find ^branch "^where ^attribute = '状态' ^and ^attrvalue = '已失败'"
                    （查找具有属性 '状态' 且属性值为 '已失败'
                    的分支。）
                    
    ^owner      ：用户。
                 容许特殊用户 '^me'。
    ^parent     ：分支规格。
                 使用 'cm ^help ^objectspec' 可了解如何指定此对象。

                 示例：
                     cm ^find ^branch "^where ^owner != '^me' ^and ^parent != '^br:/main'"
                     （查找由我以外的人创建且父分支
                     不是 '/main' 的分支。）

    ^comment    ：字符串。
    ^GUID       ：全局唯一标识符。
                 十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

    ^ID         ：整数。

                 示例：
                    cm ^find ^branch "^where ^id = 2029607"
                    （查找 ID 为 2029607 的分支。）

    复制字段。查看下文的“与复制相关的字段”。
        ^ReplLogId
        ^ReplSrcDate
        ^ReplSrcId
        ^ReplSrcRepository
        ^ReplSrcServer

^changeset:
    可以通过使用以下字段进行筛选来查找变更集：

    ^branch            ：分支规格。
                        使用 'cm ^help ^objectspec' 可了解如何指定此
                        对象。

                        示例：
                            cm ^find ^changeset "^where ^branch = '/main/scm23119'"
                            （查找分支 'scm23119' 中的所有变更集。）

    ^changesetid       ：整数。
    ^attribute         ：字符串。

                        示例：
                            cm ^find ^changeset "^where ^attribute = '状态'"
                            （查找包含属性 '状态' 的变更集。）

    ^attrvalue         ：字符串。
    ^date              ：日期。
                        请在本指南中查看“日期常量”以了解更多信息。
    ^owner             ：用户。
                        容许特殊用户 '^me'。

                        示例：
                            cm ^find ^changeset "^where ^date >= '2018/8/6' ^and ^owner != '^me'"
                            （查找创建日期等于或晚于 2018/8/6
                            并且由我以外的人创建的所有变更集。）

    ^GUID              ：全局唯一标识符。
                        十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。

                        示例：
                            cm ^find ^changeset "^where ^guid = '1b30674f-14cc-4fd7-962b-676c8a6f5cb6'"
                            （查找具有指定 GUID 的变更集。）

    ^comment           ：字符串。

                        示例：
                            cm ^find ^changeset "^where ^comment = ''"
                            （查找不含注释的变更集。）

    ^onlywithrevisions ：布尔值。
                        筛选变更集是否具有修订。

                        示例：
                            cm ^find ^changeset "^where ^onlywithrevisions = 'false'"
                            （查找不含修订的变更集。）

    ^returnparent      ：布尔值。
                        一种返回变更集父级的方法。非常适合用于编写脚本。

                        示例：
                            cm ^find ^changeset "^where ^changesetid = 29 ^and ^returnparent = 'true'"
                            （查找变更集 29 的父级。）

    ^parent            ：变更集 ID（整数）。

                        示例：
                            cm ^find ^changeset "^where ^parent = 548"
                            （查找父级为变更集 548 的所有变更集。）

    ^ID                ：整数。

    复制字段。查看下文的“与复制相关的字段”。
        ^ReplLogId
        ^ReplSrcDate
        ^ReplSrcId
        ^ReplSrcRepository
        ^ReplSrcServer

^label:
    可以通过使用以下字段进行筛选来查找标签：

    ^name      ：字符串。

                示例：
                    cm ^find ^label "^where ^name ^like '7.0.16.%'"
                    （查找名称以 '7.0.16.' 开头的标签。）

    ^attribute ：字符串。
    ^attrvalue ：字符串。
    ^date      ：日期。
                请在本指南中查看“日期常量”以了解更多信息。

                示例：
                    cm ^find ^label "^where ^date >= '^this ^month' ^and \
                      ^attribute = '发布状态' ^and ^attrvalue != '已发布'"
                    （查找本月创建并且属性 '发布状态' 设置为
                    '已发布' 以外的值的标签。）
                    
    ^owner     ：用户。
                容许特殊用户 '^me'。
    ^GUID      ：全局唯一标识符。
                十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^branch    ：分支规格。
                使用 'cm ^help ^objectspec' 可了解如何指定此对象。

                示例：
                    cm ^find ^label "^where ^branch = '/main'"
                    （查找应用于主分支的所有标签。）

    ^branchid  ：整数。
    ^changeset ：变更集 ID（整数）。

                示例：
                    cm ^find ^label "^where ^changeset = 111733"
                    （查找应用于变更集 111733 的标签。）

    ^comment   ：字符串。
    ^ID        ：整数。

    复制字段。查看下文的“与复制相关的字段”。
        ^ReplLogId
        ^ReplSrcDate
        ^ReplSrcId
        ^ReplSrcRepository
        ^ReplSrcServer

^merge:
    可以通过使用以下字段进行筛选来查找合并：

    ^srcbranch    ：分支规格。
                   使用 'cm ^help ^objectspec' 可了解如何指定此对象。

                   示例：
                      cm ^find ^merge "^where ^srcbranch = '^br:/main'"
                      （从主分支中查找合并。）

    ^srcchangeset ：变更集 ID（整数）。
    ^dstbranch    ：分支规格。
                   使用 'cm ^help ^objectspec' 可了解如何指定此对象。
    ^dstchangeset ：变更集 ID（整数）。

                   示例：
                      cm ^find ^merge "^where ^dstchangeset = 108261" \
                        --^format="{^srcbranch} {^srcchangeset} {^dstbranch} {^dstchangeset} {^owner}"
                      （查找与变更集 108261 的合并，并打印
                      格式化的输出，从而显示源（分支和变更集 ID）、
                      目标（分支和变更集 ID）和合并所有者。）

    ^date         ：日期。
                   请在本指南中查看“日期常量”以了解更多信息。
    ^owner        ：用户。
                   容许特殊用户 '^me'。
    ^GUID         ：全局唯一标识符。
                   十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^type         ：字符串。
                   可能的值有 '^merge'、'^cherrypick'、
                     '^cherrypicksubstractive'、'^interval'、'^intervalcherrypick'
                     和 '^intervalcherrypicksubstractive'

                   示例：
                      cm ^find ^merge "^where ^type = '^cherrypick' ^and ^owner = '^me'"
                      （查找我所有的挑拣。）

    ^ID           ：整数。

^replicationlog:
    可以通过使用以下字段进行筛选来查找复制日志：

    ^branch         ：分支规格。
                     使用 'cm ^help ^objectspec' 可了解如何指定此对象。

                     示例：
                         cm ^find ^replicationlog "^where ^branch = '/main/gm22358'"
                         （查找分支 'gm22358' 的复制日志。）

    ^repositoryname ：字符串。
    ^owner          ：用户。
                     容许特殊用户 '^me'。
    ^date           ：日期。
                     请在本指南中查看“日期常量”以了解更多信息。
    ^server         ：字符串。
    ^package        ：布尔值。

                     示例：
                         cm ^find ^replicationlog "^where ^package = 'T' ^and ^server ^like '%cloud%'"
                         （查找从服务器名称中包含 'cloud' 的包
                         创建的复制日志。）

    ^ID             ：整数。

^review:
    可以通过使用以下字段进行筛选来查找代码审查：

    ^status     ：字符串。
    ^assignee   ：字符串。

                 示例：
                    cm ^find ^review "^where ^status = '待定' ^and ^assignee = '^me'"
                    （查找我所有的待定审查。）

    ^title      ：字符串。
    ^target     ：对象规格：分支或变更集。
                 使用 'cm ^help ^objectspec' 可了解如何指定此对象。

                 示例：
                    cm ^find ^review "^where ^target = '^br:/main/scm17932'"
                    （查找与分支 'scm17932' 相关的审查。）

    ^targetid   ：整数。
    ^targettype ：字符串。
                 可能的值有 '^branch' 和 '^changeset'。

                 示例：
                    cm ^find ^review "^where ^targettype = '^changeset'"
                    （查找目标类型为变更集的审查。）

    ^date       ：日期。
                 请在本指南中查看“日期常量”以了解更多信息。
    ^owner      ：用户。
                 容许特殊用户 '^me'。
    ^GUID       ：全局唯一标识符。
                 十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^ID         ：整数。

^revision:
    可以通过使用以下字段进行筛选来查找修订：

    ^branch              ：分支规格。
                          使用 'cm ^help ^objectspec' 可了解如何指定此对象。
    ^changeset           ：变更集 ID（整数）。

                          示例：
                              cm ^find ^revision "^where ^changeset >= 111756"
                              （查找在变更集 111756 以及更高版本中
                              创建的修订。）

    ^item                ：字符串或整数。
    ^itemid              ：整数。

                          示例：
                              cm ^find ^revision "^where ^item = 'readme.txt' ^or ^itemid = 2250"
                              （查找项 'readme.txt' 和项 ID 2250
                              的修订。）

                              cm ^find ^revision "^where ^item = 'readme.txt' ^or ^item = 2250"
                              （获取与先前示例相同的修订。）

    ^attribute           ：字符串。
    ^attrvalue           ：字符串。

                          示例：
                              cm ^find ^revision "^where ^attribute = '状态' ^and ^attrvalue != '未完成'"
                              （查找包含属性 '状态' 且属性值
                              不是 '未完成' 的修订。）

    ^archived            ：布尔值。

                          示例：
                              cm ^find ^revision "^where ^archived = 'true'"
                              （查找在外部存储中存档
                              的修订。）

    ^comment             ：字符串。
    ^date                ：日期。
                          请在本指南中查看“日期常量”以了解更多信息。
    ^GUID                ：全局唯一标识符。
                          十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^owner               ：用户。
                          容许特殊用户 '^me'。
    ^parent              ：修订 ID（整数）。
    ^returnparent        ：布尔值。
    ^shelve              ：搁置 ID（整数）。
    ^size                ：整数（以字节为单位）。
    ^type                ：字符串。
                          可能的值有 '^dir'、'^bin' 和 '^txt'。

                          示例：
                              cm ^find ^revision "^where ^type = '^txt' and \
                                ^size > 300000 ^and ^owner = '^me' and ^date >= '2 ^months ^ago'"
                              （查找我两个月前创建且大小
                              大于 3MB 的文本修订。）

    ^workspacecheckoutid ：整数。
    ^ID                  ：整数。

    复制字段。查看下文的“与复制相关的字段”。
        ^ReplLogId
        ^ReplSrcDate
        ^ReplSrcId
        ^ReplSrcRepository
        ^ReplSrcServer

^shelve:
    可以通过使用以下字段进行筛选来查找搁置：

    ^owner     ：用户。
                容许特殊用户 '^me'。
    ^date      ：日期。
                请在本指南中查看“日期常量”以了解更多信息。

                示例：
                    cm ^find ^shelve "^where ^owner != '^me' ^and ^date >= '^1 ^years ^ago'"
                    （查找去年我以外的人创建的
                    搁置。）

    ^attribute ：字符串。
    ^attrvalue ：字符串。
    ^comment   ：字符串。
    ^GUID      ：全局唯一标识符。
                十六进制 ID，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
    ^parent    ：整数。
    ^shelveid  ：整数。

                示例：
                    cm ^find ^shelve "^where ^shelveid = 2"
                    （查找名称为 2 的搁置。）

    ^ID        ：整数。

                示例：
                    cm ^find ^shelve "^where ^id >= 3848"
                    （查找对象 ID 大于 3848 的搁置。）

    复制字段。查看下文的“与复制相关的字段”。
        ^ReplLogId
        ^ReplSrcDate
        ^ReplSrcId
        ^ReplSrcRepository
        ^ReplSrcServer


与复制相关的字段：
    许多对象会跟踪复制数据，这意味着 Plastic 会跟踪最初创建复制
    的位置。

    可以使用的字段包括：

        ^ReplSrcServer     ：存储库规格。表示“复制源服务器”。
                            从中复制对象的服务器。

              示例：
                            cm ^find ^branch "^where ^replsrcserver='skull.codicefactory.com:9095'"
                            （查找从服务器 'skull' 复制的分支。）

        ^ReplSrcRepository ：字符串。表示“复制源存储库”。这是
                            从中复制对象的存储库。

              示例：
                            cm ^find ^branch "^where ^replsrcserver = 'skull.codicefactory.com:9095' \
                              ^and ^replsrcrepository = 'codice'"
                            （查找从服务器 'skull' 和存储库 'codice'
                            复制的分支。）

        ^ReplLogId         ：整数。复制操作的 ID。在 Plastic 中，
                            每次从复本创建新对象时，
                            都会创建一个新的 'replicationlog'。

              示例：
                            cm ^find ^revision "^where ^repllogid = 2019974"
                            （查找从复本 2019974 复制
                            的修订。）

        ^ReplSrcDate       ：日期。这是实际发生复制的
                            日期。
                            复制的对象将保留其原始创建
                            日期，如果要查找在特定时间
                            范围内复制的对象，则此字段
                            很有用。

              示例：
                            cm ^find ^label "^where ^replsrcdate >= '^one ^month ^ago' \
                              ^and ^date >= '15 ^days ^ago'"
                            （查找 15 天前创建并在一个月前
                            复制的标签。）
                     
                            cm ^find ^replicationlog "^where ^date > '^one ^week ^ago'"
                            8780433  27/09/2018 8:49:38 codice@BACKYARD:8087 F   mbarriosc
                            （查找一周前创建的复制日志。）

                            现在可以检查复制的分支是否是
                            在复制之前创建的：

                            cm ^find ^branch "^where ^repllogid = 8780433"
                            8780443  26/09/2018 12:20:55 /main/scm23078 maria    codice T

        ^ReplSrcId         ：整数。这是复制源服务器的 ID。
                            可以使用 'cm ^find' 命令搜索
                            '^replicationsource' 对象来发现此 ID。

              示例：
                            cm ^find ^replicationsource
                            7860739  codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
                            8175854  codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9

                            现在可以查找从 codice@AFRODITA:8087
                            复制的变更集：

                            cm ^find ^changesets "^where ^replsrcid = 7860739"


日期常量：
    可以使用遵循计算机本地化设置的日期格式。
    例如，如果计算机以 'MM-dd-yyyy' 格式显示日期，
    则可以在查询中使用 '12-31-2019' 之类的日期。

    还可以使用以下常量来简化查询：
        '^today'         ：今天的日期。
        '^yesterday'     ：昨天的日期。
        '^this ^week'     ：本周星期一的日期。
        '^this ^month'    ：本月第一天的日期。
        '^this ^year'     ：本年 1 月 1 日。
        '^one ^day ^ago'   ：当前日期前一天。
        '^one ^week ^ago'  ：当前日期前七天。
        '^one ^month ^ago' ：当前日期前一个月。
        'n ^days ^ago'    ：当前日期前 'n' 天。
        'n ^months ^ago'  ：当前日期前 'n' 个月。
        'n ^years ^ago'   ：当前日期前 'n' 年。

    以下 '^where' 子句对于类型为 '^date' 的字段有效：
        '(...)^where ^date > '^today' (...)'
        '(...)^where ^date < '^yesterday' (...)'
        '(...)^where ^date > '^this ^week' (...)'
        '(...)^where ^date > '^this ^month' (...)'
        '(...)^where ^date < '^one ^day ^ago' ^and ^date > '3 ^days ^ago' (...)'
        '(...)^where ^date < '^one ^week ^ago' ^and ^date > '3 ^weeks ^ago' (...)'
        '(...)^where ^date < '^one ^month ^ago' ^and ^date > '3 ^months ^ago' (...)'
        '(...)^where ^date > '1 ^year ^ago' (...)'

    还可以在 'cm ^find' 命令中强制使用特定日期格式，方法是使用
    --^dateformat 标志。请查看 'cm ^find --^help' 以了解更多详细信息。

== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
显示可用的触发器类型。

== CMD_USAGE_TRIGGER_SHOWTYPES ==
用法：

    cm ^trigger ^showtypes

== CMD_DESCRIPTION_SHOWACL ==
显示对象的 ACL。

== CMD_USAGE_SHOWACL ==
用法：

    cm ^showacl | ^sa <对象规格> [--^extended] [--^xml[=<输出文件>]]
                                [--^encoding=<名称>]

    对象规格         要显示相应 ACL 的对象的规格。
                        此命令的有效对象为：
                        存储库服务器、存储库、分支、变更集、标签、项
                        和属性。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）

选项：

      --^extended        显示 ACL 层次结构树。
      --^xml             以 XML 格式将输出打印到标准输出。
                        可以指定输出文件。
      --^encoding        与 '--^xml' 选项结合使用，指定要在 XML 输出
                        中使用的编码（例如：utf-8）。
                        请参阅位于以下网址的 MSDN 文档：
                        http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                        以查看包含受支持编码及其格式的表格
                        （位于页面末尾的“名称”列中）。

== CMD_HELP_SHOWACL ==
示例：

    cm ^showacl ^repserver:PlasticServer:8084
    （显示所选服务器的 ACL。）

    cm ^sa ^br:/main --^extended
    （显示所选分支规格的 ACL 层次结构树。）

== CMD_DESCRIPTION_SHOWCOMMANDS ==
显示所有可用命令。

== CMD_USAGE_SHOWCOMMANDS ==
用法：

    cm ^showcommands

== CMD_HELP_SHOWCOMMANDS ==

== CMD_DESCRIPTION_SHOWOWNER ==
显示对象的所有者。

== CMD_USAGE_SHOWOWNER ==
用法：

    cm ^showowner | ^so <对象规格>

    对象规格         要显示相应所有者的对象的规格。
                        对象必须为下列其中之一：
                        存储库服务器、存储库、分支、变更集、
                        标签、属性、修订和项。
                        （使用 'cm ^help ^objectspec' 可进一步了解规格。）

== CMD_HELP_SHOWOWNER ==
备注：

    此命令将显示对象的所有者。所有者可以是用户或
    组。可以使用 'cm ^setowner' 命令修改所有者。

示例：

    cm ^showowner ^repserver:PlasticServer:8084
    （显示所选服务器的所有者。）

    cm ^so ^item:samples\
    （显示所选项规格的所有者。）

== CMD_DESCRIPTION_SHOWPERMISSIONS ==
列出可用的权限。

== CMD_USAGE_SHOWPERMISSIONS ==
用法：

      cm ^showpermissions | ^sp

== CMD_HELP_SHOWPERMISSIONS ==
示例：

    cm ^showpermissions

== CMD_DESCRIPTION_SHOWSELECTOR ==
显示工作区选择器。

== CMD_USAGE_SHOWSELECTOR ==
已弃用此命令。为了向后兼容，此命令仍然存在，
但是在 Plastic SCM 4.0 中，已在很大程度上弃用选择器。仍然存在的选择器
是为了指定工作分支或变更集，但不再支持
用于筛选路径的旧规则。

用法：

    cm ^showselector | ^ss [<工作区路径> | <工作区规格>]

    工作区路径             用于显示选择器的工作区的路径。
    工作区规格             工作区的规格。（使用 'cm ^help ^objectspec' 可
                        可进一步了解工作区规格。）

== CMD_HELP_SHOWSELECTOR ==
备注：

    如果路径和工作区规格均未指定，则该命令将采用
    当前目录作为工作区路径。

示例：

    cm ^showselector c:\workspace
    （显示所选工作区路径的选择器。）

    cm ^ss
    （显示当前工作区的选择器。）

    cm ^showselector > mySelector.txt
    （将当前工作区的选择器写入文件。）

    cm ^showselector ^wk:mywk@reptest
    （显示存储库 'reptest' 中的工作区 'mywk' 的选择器。）

== CMD_DESCRIPTION_SUPPORT ==
允许用户执行与支持相关的操作。

== CMD_USAGE_SUPPORT ==
用法：

    cm ^support <命令> [选项]

命令：

    ^bundle

    要获取有关每条命令的更多信息，请运行：
    cm ^support <命令> --^usage
    cm ^support <命令> --^help

== CMD_HELP_SUPPORT ==
示例：

    cm ^support
    cm ^support ^bundle
    cm ^support ^bundle c:\outputfile.zip

== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
创建带有相关日志的“支持捆绑包”包。
可以在请求帮助、询问其他信息或者提交 bug 时
附加该文件。

== CMD_USAGE_SUPPORT_BUNDLE ==
用法：

    cm ^support ^bundle [<输出文件>]

选项：

    输出文件          在指定的位置创建“支持捆绑包”
                        包。

== CMD_HELP_SUPPORT_BUNDLE ==
备注：

此命令允许用户创建一个“支持捆绑包”包，然后便可在请求帮助、
询问其他信息或提交 bug 时附加这个包。
用户可以选择指定输出文件的位置；否则，
输出文件将写入到临时目录。

示例：

    cm ^support ^bundle
    （在临时目录中创建“支持捆绑包”。）

    cm ^support ^bundle c:\outputfile.zip
    （在指定位置创建“支持捆绑包”。）

== CMD_DESCRIPTION_SWITCH ==
将工作区切换到分支、变更集、标签或搁置集。

== CMD_USAGE_SWITCH ==
用法：

    cm ^switch (<分支规格> | <变更集规格> | <标签规格> | <搁置规格>)
              [--^workspace=<路径>] [--^repository=<名称>]
              [--^forcedetailedprogress]

    （使用 'cm ^help ^objectspec' 可进一步了解分支、变更集、标签、
    和搁置集规格。）

选项：

    --^workspace             工作区所在的路径。
    --^repository            切换到指定的存储库。
    --^forcedetailedprogress 即使在标准输出被重定向的情况下也要强制
                            显示详细进度。

== CMD_HELP_SWITCH ==
备注：

    此命令允许用户将工作区树更新为指定对象
    （分支、标签、搁置集或变更集）的内容。

示例：

    cm ^switch ^br:/main
    cm ^switch ^lb:Rel1.1
    cm ^switch ^br:/main/scm002 --^repository=rep2
    cm ^switch ^cs:4375
    cm ^switch ^sh:2

== CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
将分支设置为工作分支。

== CMD_USAGE_SWITCH_TO_BRANCH ==
已弃用此命令。请改用 cm switch。

用法：

    cm ^switchtobranch [选项] [分支规格]

    分支规格：分支的规格。

选项：

    --^label=名称 | --^changeset=数字：从指定标签或变更集
      加载修订。如果未提供任何分支规格，则需要这些选项
      之一。
    --^changeset=变更集：切换到指定的变更集。
    --^repository=存储库：切换到指定的存储库。
    --^workspace | -wk=路径：工作区所在的路径。

== CMD_HELP_SWITCH_TO_BRANCH ==
备注：

    此命令允许用户在分支中工作。
    如果未指定分支规格，则必须指定标签或变更集。
    如果未指定存储库，则分支将设置为当前存储库。

示例：

    cm ^switchtobranch ^br:/main
    cm ^switchtobranch ^br:/main/task001

    cm ^switchtobranch --^label=BL050
    （只读配置。该命令将加载已标记的变更集
    的内容。）

== CMD_DESCRIPTION_SYNC ==
与 Git 同步。

== CMD_USAGE_SYNC ==
用法：

    cm ^synchronize | ^sync <存储库规格> ^git [<url> [--^user=<用户名> --^pwd=<密码>]]
                          [(--^txtsimilaritypercent | --^binsimilaritypercent | \
                            --^dirsimilaritypercent)=<值>]
                          [--^author] [--^skipgitlfs]


    存储库规格             存储库的规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解存储库规格。）
    git                 （默认值）。

选项：

    url                       远程存储库 URL（http(s):// 或 git:// 或
                              SSH URL）。
    --^user                    指定的 URL 的用户名。
    --^pwd                     指定的 URL 的密码。
    --^txtsimilaritypercent \
    --^binsimilaritypercent \
    --^dirsimilaritypercent
                              要检测已移动的项，与 Plastic SCM GUI 的
                              方法相同。
    --^author                  使用 Git 作者提供的名称和时间戳值。
                              （默认为 Git 提交者）
    --^skipgitlfs              忽略 .gitattributes 文件中的
                              Git LFS 配置。行为类似于不支持
                              Git LFS。

== CMD_HELP_SYNC ==
备注：

    如果 Git 存储库需要用户名和密码，则应使用 '^url'、'--^user'、
    和 '--^pwd' 选项。
    如果 Git 存储库不需要用户名和密码，则应在第一次同步
    操作中使用 '^url' 选项。在后续的同步操作中，'^url'
    选项是可选的。

    要使用 SSH 协议执行同步，必须将 'ssh' 客户端
    添加到 PATH 环境变量，并正确配置为连接到
    远程主机（即配置私钥/公钥）。

示例：

    cm ^sync default@localhost:8087 ^git git://localhost/repository

== CMD_DESCRIPTION_TRIGGER ==
允许用户管理触发器。

== CMD_USAGE_TRIGGER ==
用法：

    cm ^trigger | ^tr <命令> [选项]

命令：

    ^create | ^mk
    ^delete | ^rm
    ^edit
    ^list   | ^ls
    ^showtypes

    要获取有关每条命令的更多信息，请运行：
    cm ^trigger <命令> --^usage
    cm ^trigger <命令> --^help

== CMD_HELP_TRIGGER ==
示例：

    cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
    cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
    cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
    cm ^tr ^rm ^after-setselector 4
    cm ^tr ^showtypes

== CMD_DESCRIPTION_TUBE ==
运行与 Plastic Tube 有关的命令。

== CMD_USAGE_TUBE ==
用法：

    cm ^tube ^config -^u=<用户> -^p=<密码>
    （配置 Plastic SCM 以将 Plastic Tube 与指定的用户和密码
    配合使用。）


    cm ^tube ^create <远程用户>
    （创建 Tube“远程用户 -> 我的用户”。
    用户“我的用户”允许“远程用户”连接到“我的用户”服务器。
    可以建立从“远程用户”到“我的用户”的连接。
    只能创建其他用户到当前 Tube 用户的 Tube。）

    cm ^tube ^remove <远程用户>
    （删除 Tube“远程用户 -> 我的用户”。）


    cm ^tube ^local
    （列出在本地服务器上共享的本地存储库以及共享到
    的用户。）
    
    cm ^tube ^remote
    （列出与当前 Tube 用户共享的共享远程
    存储库。）


    cm ^tube ^share <存储库规格>[ ...]-^u=<远程用户> -^a=(^pull | ^push | ^pull,^push)
    （与远程用户共享本地存储库并设置指定的
    访问模式。使用空格对各个存储库规格进行分隔。）

    cm ^tube ^unshare <存储库规格>[ ...]-^u=<远程用户>
    （取消与远程用户共享本地存储库。使用空格
    对各个存储库规格进行分隔。）


    cm ^tube ^connect
    （将 Plastic SCM 服务器连接到 Plastic Tube。）
    cm ^tube ^disconnect
    （断开 Plastic SCM 服务器与 Plastic Tube 的连接。）
    cm ^tube ^status
    （显示 Plastic SCM 服务器是否已连接到 Plastic Tube。）

选项

    -^u                Tube 用户（plasticscm.com 用户）。
    -^p                用户密码。
    -^a                设置访问模式。
    存储库规格          存储库的规格。（使用 'cm ^help ^objectspec' 可
                      进一步了解存储库规格。）

== CMD_HELP_TUBE ==
备注：

    使用 'cm ^tube' 命令来管理 Plastic Tube。

示例：

    cm ^tube ^config -^u=ruben@codicesoftware.com -^p=rubenpassword

    cm ^tube ^create pablo@codicesoftware.com
    （'pablo@codicesoftware.com' 可以连接到当前的 Plastic Tube 用户）
    cm ^tube ^remove pablo@codicesoftware.com

    cm ^tube ^local
    cm ^tube ^remote

    cm ^tube ^share repo@server:8087 -^u=pablo@codicesoftware.com -^a=^pull,^push
    cm ^tube ^share repo@server:8087 doc@server:8087 -^u=pablo@codicesoftware.com -^a=^push
    cm ^tube ^unshare repo@server:8087 -^u=pablo@codicesoftware.com

    cm ^tube ^connect
    cm ^tube ^disconnect
    cm ^tube ^status

== CMD_DESCRIPTION_UNCO ==
撤销项的签出。

== CMD_USAGE_UNCO ==
用法：

    cm ^undocheckout | ^unco <项路径>[ ...][-^a | --^all] [--^symlink] [--^silent]
                           [--^machinereadable [--^startlineseparator=<分隔符>]
                            [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

    项路径           要应用操作的项。使用空格对各个路径进行
                        分隔。使用双引号 (" ") 指定包含空格
                        的路径。
                        使用 . 将操作应用到当前目录。

选项：

    -^a | --^all           撤销指定项中的所有更改。如果
                         已签出项，则签出将被
                         还原。如果项是在本地修改的，则
                         修改将被还原。
    --^symlink            将 undocheckout 操作应用于链接而不是
                         目标。
    --^silent             不显示任何输出。
    --^machinereadable    以易于解析的格式输出结果。
    --^startlineseparator 与 '--^machinereadable' 标志结合使用，
                         指定行应如何开头。
    --^endlineseparator   与 '--^machinereadable' 标志结合使用，
                         指定行应如何结尾。
    --^fieldseparator     与 '--^machinereadable' 标志结合使用，
                         指定应如何分隔字段。

== CMD_HELP_UNCO ==
备注：

    如果已签出某个项并且不想将这个项签入，则可以
    使用此命令撤销签出。文件和文件夹都可以取消
    签出。项将更新为签出之前的状态。

    要求：
      - 项必须受源代码管理。
      - 必须签出项。

从 stdin 读取输入：

    '^undocheckout' 命令可从 stdin 读取路径。为此，请传递
    一个破折号 "-"。
    示例：cm ^undocheckout ^checkin -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要撤销签出的文件。
    示例：
      dir /S /B *.c | cm ^undocheckout --^all -
      （在 Windows 中，撤销对工作区中所有 .c 文件的签出。）

示例：

    cm ^undocheckout .
    （撤销当前目录中的签出。）

    cm ^undocheckout file1.txt file2.txt
    cm unco c:\workspace\file.txt
    （撤销签出所选文件。）

    cm ^unco -^a file1.txt
    （撤销对 'file1.txt' 的签出或本地修改）

    cm ^unco 链接 --^symlink
    （将 undocheckout 操作应用于链接文件而不是目标，
    适用于 UNIX 环境。）

    cm ^status --^short --^changelist=pending_to_review | cm ^undocheckout -
    （撤销客户端更改列表。
    以上命令将列出名为 'pending_to_review'
    的更改列表中的路径，并且路径列表将重定向到
    undocheckout 命令的输入。）

    cm ^unco .--^machinereadable
    （撤销当前目录中的签出，并以易于解析的
    简化格式打印结果。）

    cm ^unco .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" \
      --^fieldseparator=","
    （撤销当前目录中的签出，并以易于解析的简化
    格式打印结果，以指定的字符串作为行的开头和结尾以及
    对各字段进行分隔。）

== CMD_DESCRIPTION_UNCOUNCHANGED ==
撤销未更改的已签出项。

== CMD_USAGE_UNCOUNCHANGED ==
用法：

    cm ^uncounchanged | ^unuc <项路径>[ ...][-^R | -^r | --^recursive]
                            [--^symlink] [--^silent]

    项路径           要应用操作的项。使用空格对各个路径进行
                        分隔。使用双引号 (" ") 指定包含空格
                        的路径。
                        使用 . 将操作应用到当前目录。

选项：

    -^R                  在指定路径中以递归方式撤销未更改的项。
    --^symlink           将 uncounchanged 操作应用于链接而不是
                        目标。
    --^silent            不显示任何输出。

== CMD_HELP_UNCOUNCHANGED ==
备注：

    此命令是从工作区根目录以递归方式应用的。

从 stdin 读取输入：

    '^uncounchanged' 命令可从 stdin 读取路径。为此，请传递
    一个破折号 "-"。
    示例：cm ^uncounchanged -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要撤销签出的
    未更改文件。
    示例：
      dir /S /B *.c | cm ^uncounchanged -
      （在 Windows 中，撤销对工作区中所有未更改的 .c 文件
      的签出。）

示例：

    cm ^uncounchanged .-^R
    （在当前目录中以递归方式撤销未更改文件的签出。）

    cm ^unuc /home/myuser/mywk/project/templates -^R
    （在所选目录中以递归方式撤销未更改文件的签出。）

== CMD_DESCRIPTION_UNDELETE ==
使用特定修订来取消删除某个项。

== CMD_USAGE_UNDELETE ==
用法：

    cm ^undelete <修订规格> <路径>

    修订规格             所含内容将加载到工作区中的
                        修订的规格。（使用 'cm ^help ^objectspec' 可
                        进一步了解修订规格。）
    路径                还原路径。

== CMD_HELP_UNDELETE ==
备注：

    要取消删除的项不应加载到工作区中。

    Xlink 不支持 '^undelete' 操作。

示例：

    cm ^undelete ^revid:756 C:\mywks\src\foo.c
    cm ^undelete ^itemid:68#^cs:2 C:\mywks\dir\myfile.pdf
    cm ^undelete ^serverpath:/src#^br:/main C:\mywks\Dir

== CMD_DESCRIPTION_UNDOCHANGE ==
撤销路径中的更改。

== CMD_USAGE_UNDOCHANGE ==
用法：

    cm ^undochange | ^unc <项路径>[ ...][-^R | -^r | --^recursive]

    项路径       要应用操作的项。使用空格对各个路径进行
                    分隔。使用双引号 (" ") 指定包含空格
                    的路径。
                    使用 . 将操作应用到当前目录。

选项：

    -^R              以递归方式应用操作。

== CMD_HELP_UNDOCHANGE ==
备注：

    如果已签出某个项或已修改但未签入这个项，并且不想
    签入这个项，则可以使用此命令撤销更改。项将
    更新为之前的内容。

从 stdin 读取输入：

    '^undochange' 命令可从 stdin 读取路径。为此，请传递
    一个破折号 "-"。
    示例：cm ^undochange -

    路径将一直读取到有空行输入为止。
    这种情况下允许使用竖线指定要撤销更改的文件。
    示例：
      dir /S /B *.c | cm ^undochange -
      （在 Windows 中，撤销对工作区中所有 .c 文件的更改。）

示例：

    cm ^unc .
    （撤销当前目录中的文件更改。）

    cm ^undochange .-^R
    （以递归方式撤销当前目录中的文件更改。）

    cm ^unc file1.txt "file 2.txt"
    （撤销所选文件的更改。）

    cm ^unc c:\workspace\file.txt
    （撤销所选文件的更改。）

== CMD_DESCRIPTION_UNDO ==
撤销工作区中的更改。

== CMD_USAGE_UNDO ==
用法：

    cm ^undo [<路径>[ ...]] [--^symlink] [-^r | --^recursive] [<筛选器>[ ...]]
            [--^silent | --^machinereadable [--^startlineseparator=<分隔符>]
                            [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]

    路径                要应用操作的文件或目录
                        的路径。使用双引号 (" ") 指定包含空格的
                        路径。使用空格对各个路径进行分隔。
                        如果未指定路径，则默认情况下，
                        撤销操作将应用于当前目录中的所有
                        文件。
    筛选器              将一个或多个指定筛选器应用于给定
                        路径。使用空格对各个筛选器进行分隔。请参阅
                        “筛选器”部分以了解更多信息。

选项：

    --^symlink               将撤销操作应用于符号链接而不是
                            目标。
    -^r                      以递归方式执行撤销。
    --^silent                不显示任何输出。
    --^machinereadable       以易于解析的格式输出结果。
    --^startlineseparator    与 '--^machinereadable' 标志结合使用，指定
                            行应如何开头。
    --^endlineseparator      与 '--^machinereadable' 标志结合使用，指定
                            行应如何结尾。
    --^fieldseparator        与 '--^machinereadable' 标志结合使用，指定
                            应如何分隔字段。
筛选器：

    如果未指定标志，则默认情况下将撤销所有更改，但是
    可以使用以下一个或多个标志来筛选路径。
    如果文件或目录匹配一个或多个指定种类的更改，
    则将撤销该文件或目录上的所有更改。
    例如，如果同时指定了 '--^checkedout' 和 '--^moved'，则在
    已签出并移动文件的情况下，两项更改都将被撤销。

    --^checkedout            选择已签出的文件和目录。
    --^unchanged             选择内容不变的文件。
    --^changed               选择本地更改的或签出的文件和
                            目录。
    --^deleted               选择已删除的文件和目录。
    --^moved                 选择已移动的文件和目录。
    --^added                 选择已添加的文件和目录。

== CMD_HELP_UNDO ==
备注：

    '^undo' 命令有风险，因为该命令在撤销工作后将不可逆。
    ^undo 完成后，无法将受其影响的文件和目录
    恢复到先前状态。如果参数中
    未指定路径，则默认情况下，该命令将撤销
    当前目录中的所有更改，但不采用递归方式。
    从 /src 目录执行时，以下命令是等效的：

        /src
        |- file.txt
        |- code.cs
        \- /test
           |- test_a.py
           \- test_b.py

        cm ^undo
        cm ^undo *
        cm ^undo file.txt code.cs /test

        cm ^undo .
        cm ^undo /src file.txt code.cs

    如果希望操作以递归方式执行，必须指定 '-^r' 标志。

    撤销某一目录下的所有更改（包括影响目录
    本身的更改）：

        cm ^undo 目录路径 -^r

    如果目录路径是工作区路径，则工作区中的每个更改都将
    被撤销。

已删除项：

    要撤销对文件和目录的删除，必须指定项的
    完整路径，或者指定所属目录并使用递归 ('-^r')
    标志。

    例如：

    cm ^undo .
    （不撤销当前目录中的删除。）

    cm ^undo .-^r
    （以递归方式撤销当前目录中的所有删除（和其他更改）。）

    cm ^undo src/file.txt
    （撤销对 src/file.txt 的删除（或其他更改）。）

示例：

    cm ^undo .-^r
    （以递归方式撤销当前目录中的所有更改。如果从工作区的
    根目录执行，则撤销整个工作区中的所有更改。）

    cm ^co file.txt
    cm ^undo file.txt
    （撤销对 'file.txt' 的签出。）

    ^echo ^content >> file.txt
    cm ^undo file.txt
    （撤销对 'file.txt' 的本地更改。）

    cm ^undo src
    （撤销对 src 目录及其文件的更改。）

    cm ^undo src/*
    （撤销对 src 中包含的每个文件和目录的更改，而不会
    影响 src。）

    cm ^undo *.cs
    （撤销对当前目录中与 *.cs 匹配的每个文件或目录的
    更改。）

    cm ^undo *.cs -^r
    （撤销对当前目录中以及下级所有目录中与 *.cs 匹配的
    每个文件或目录的更改。）

    cm ^co file1.txt file2.txt
    ^echo ^content >> file1.txt
    cm ^undo --^unchanged
    （撤销对未更改的 'file2.txt' 的签出，并忽略本地更改的
    'file1.txt'。）

    ^echo ^content >> file1.txt
    ^echo ^content >> file2.txt
    cm ^co file1.txt
    cm ^undo --^checkedout
    （撤销已签出文件 'file1.txt' 中的更改，并忽略 'file2.txt'，
    因为后者未签出。）

    cm ^add file.txt
    cm ^undo file.txt
    （撤销添加 'file.txt'，使该文件再次成为私有文件。）

    ^rm file1.txt
    ^echo ^content >> file2.txt
    cm ^add file3.txt
    cm ^undo --^deleted --^added *
    （撤销 'file1.txt' 的删除和 'file3.txt' 的添加，并忽略 'file2.txt'
    的更改。）

== CMD_DESCRIPTION_LOCK_UNLOCK ==
撤销锁定服务器上的项锁定。

== CMD_USAGE_LOCK_UNLOCK ==
用法：

    cm ^lock ^unlock [<存储库服务器规格>] <GUID>[ ...]

    存储库服务器规格   存储库服务器规格。（使用 'cm ^help ^objectspec'
                    可进一步了解存储库服务器规格。）
    GUID            要解锁的项 GUID 的列表。使用空格对各个 GUID
                    进行分隔。

== CMD_HELP_LOCK_UNLOCK ==
备注：

    - 该命令使用指定的服务器来解锁项。
    - 如果未指定服务器，则该命令会尝试从当前工作区
      获取服务器。
    - 如果在先前的步骤中未计算服务器，则会从当前的
      Plastic SCM 客户端配置中获取服务器。
    - 只有服务器的管理员才能运行 'cm ^unlock' 命令。
    - 要指定 GUID，格式应为 32 位数字，并用
      短横线分隔（也可以选择用花括号括起来）：

        {00000000-0000-0000-0000-000000000000}
      或 00000000-0000-0000-0000-000000000000

示例：

    cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
    （撤销所选项锁定。）

    cm ^lock ^unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \
      bcb98a61-2f62-4309-9a26-e21a2685e075
    （撤销名为 'DIGITALIS' 的锁定服务器上的所选项锁定。）

    cm ^lock ^unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \
      71263c17-5eaf-5271-4d2c-a25f72e101d4
    （撤销名为 'tardis' 的 Cloud 锁定服务器上的所选项锁定。）

== CMD_DESCRIPTION_UPDATE ==
更新工作区并下载最新的更改。

== CMD_USAGE_UPDATE ==
用法：

    cm ^update [<项路径> | --^last]
              [--^changeset=<变更集规格>] [--^cloaked] [--^dontmerge] [--^forced]
              [--^ignorechanges] [--^override] [--^recursewk] [--^skipchangedcheck]
              [--^silent] [--^verbose] [--^xml[=<输出文件>]] [--^encoding=<名称>]
              [--^machinereadable [--^startlineseparator=<分隔符>]
                [--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
              [--^forcedetailedprogress]

    项路径           要更新的路径。
                        使用 . 将更新应用到当前目录。
                        如果未指定路径，则当前工作区
                        将完全更新。
    --^last              在更新之前，将工作区选择器
                        从变更集配置或标签配置更改为
                        分支配置。
                        选择器将更改为变更集或标签
                        所属的分支。

选项：

    --^changeset             将工作区更新为特定变更集。
                            （使用 'cm ^help ^objectspec' 可进一步了解
                            变更集规格。）
    --^cloaked               在更新操作中包含掩蔽的项。
                            如果未指定此选项，则在操作中
                            将忽略掩蔽的项。
    --^dontmerge             如果在更新操作期间需要
                            合并更新，请不要执行合并。
    --^forced                强制将项更新为选择器中指定的
                            修订。
    --^ignorechanges         忽略在更新工作区时
                            检测到待定更改的情况下显示
                            的待定更改警告消息。
    --^override              覆盖不受 Plastic SCM 控制的已更改文件。
                            这些文件的内容将被服务器内容
                            覆盖。
    --^recursewk             更新在当前路径中找到的所有
                            工作区。适合用于更新特定路径中包含的
                            所有工作区。
    --^skipchangedcheck      该更新在开始之前会检查工作区中是否
                            存在本地更改。如果始终在修改
                            文件之前签出，则可以进行此检查并
                            加快操作速度。
    --^silent                不显示任何输出。
    --^verbose               显示其他信息。
    --^xml                   以 XML 格式将输出打印到标准输出。
                            可以指定输出文件。
    --^encoding              与 --^xml 选项结合使用，指定要在 XML 输出
                            中使用的编码（例如：utf-8）。
                            请参阅位于以下网址的 MSDN 文档：
                            http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                            以查看包含受支持编码及其格式的表格
                            （位于页面末尾的“名称”列中）。
    --^machinereadable       以易于解析的格式输出结果。
    --^startlineseparator    与 '--^machinereadable' 标志结合使用，
                            指定行应如何开头。
    --^endlineseparator      与 '--^machinereadable' 标志结合使用，
                            指定行应如何结尾。
    --^fieldseparator        与 '--^machinereadable' 标志结合使用，
                            指定应如何分隔字段。
    --^forcedetailedprogress 即使在标准输出被重定向的情况下也要强制显示
                            详细进度。
== CMD_HELP_UPDATE ==
备注：

    '^update' 命令仅下载所需的文件。

    该命令采用递归操作。

    使用 --^last' 选项时，无需指定路径。
    在这种情况下，当前工作目录所属的工作区
    将更新。
    （切记，如果工作区选择器先前指向某个
    变更集或标签，则指定该标志可能导致
    工作区选择器更改为分支配置。）


示例：

    cm ^update
    （更新当前工作区中的所有项。）

    cm ^update .
    （更新当前目录以及所有子项。）

    cm ^update .--^forced --^verbose
    （强制检索所有修订。）

    cm ^update --^last

    cm ^update .--^machinereadable --^startlineseparator=">"
    （更新当前目录，并以易于解析的简化格式
    打印结果，以指定的字符串作为行的
    开头。）

== CMD_DESCRIPTION_VERSION ==
显示当前的客户端版本号。

== CMD_USAGE_VERSION ==
用法：

    cm ^version

== CMD_HELP_VERSION ==

== CMD_DESCRIPTION_WHOAMI ==
显示当前的 Plastic SCM 用户。

== CMD_USAGE_WHOAMI ==
用法：

    cm ^whoami

== CMD_HELP_WHOAMI ==

== CMD_USAGE_WKTREENODESTATUS ==
用法：

    cm ^wktreenodestatus 路径1, 路径2, ...

== CMD_DESCRIPTION_WORKSPACE ==
允许用户管理工作区。

== CMD_USAGE_WORKSPACE ==
用法：

    cm ^workspace | ^wk <命令> [选项]

命令：

    ^list   | ^ls
    ^create | ^mk
    ^delete | ^rm
    ^move   | ^mv
    ^rename

    要获取有关每条命令的更多信息，请运行：
    cm ^workspace <命令> --^usage
    cm ^workspace <命令> --^help

== CMD_HELP_WORKSPACE ==
示例：

    cm ^workspace ^create myWorkspace 工作区路径
    cm ^workspace ^list
    cm ^workspace ^delete myWorkspace

== CMD_DESCRIPTION_WORKSPACE_CREATE ==
创建新的工作区。

== CMD_USAGE_WORKSPACE_CREATE ==
用法：

    cm ^workspace | ^wk [^create | ^mk] <工作区名称> <工作区路径> [<存储库规格>]
                      [--^selector[=<选择器文件>]
    （创建新的工作区。）

    cm ^workspace | ^wk [^create | ^mk] <工作区名称> <工作区路径> --^dynamic --^tree=[<树>]
    （创建动态工作区。此功能仍处于实验阶段，
    仅适用于 Windows。）

    工作区名称             新工作区的名称。
    工作区路径             新工作区的路径。
    存储库规格            使用指定的存储库创建新的工作区。
                        存储库规格：查看 'cm ^help ^objectspec'。

选项：

    --^selector          编辑新工作区的选择器。
                        如果指定了选择器文件，则会从指定文件
                        为新工作区设置选择器。
    --^dynamic           创建动态工作区。此功能仍处于
                        实验阶段，仅适用于 Windows。
                        指定此标志需要使用 --^tree 参数。
    --^tree              与 '--^dynamic' 标志结合使用，指定要
                        加载动态工作区的初始点。此选项
                        可以是分支、变更集或标签规格。
                        工作区稍后将使用规格中的
                        存储库。（使用 'cm ^help ^objectspec' 可进一步了解规格。）

== CMD_HELP_WORKSPACE_CREATE ==
备注：

    - 工作区是映射到本地文件系统的存储库的视图。
      工作区选择器可以定义用于指定工作区内容的规则。
      使用 'cm ^showselector' 显示工作区选择器，或使用 'cm ^setselector' 修改
      工作区选择器。
    - 如果存储库规格和 '--^selector' 均未指定，则工作区
      将自动配置为使用 client.conf 文件中配置的
      服务器的第一个存储库（按字母顺序）。
    - 动态工作区是一项实验性功能（仅适用于 Windows），
      并需要运行 plasticfs.exe 程序。

示例：

    cm ^workspace ^create myworkspace c:\workspace
    cm ^wk ^mk myworkspace /home/john/plastic_view
    （分别在 Windows 和 Linux 中创建 'myworkspace' 工作区。）

    cm ^wk mywktest c:\wks\wktest --^selector=myselector.txt
    （使用 'myselector.txt' 文件中的选择器创建 'mywktest' 工作区。）

    cm ^wk mywkprj c:\wks\wkprj myrep@^repserver:localhost:8084
    （使用所选存储库创建 'mywkprj' 工作区。）

    cm ^wk mywkprj c:\dynwks\mywkprj --^dynamic --^tree=^br:/main@myrep@localhost:8084
    （使用 'myrep@localhost:8084' 存储库创建动态的 'mywkprj'
     工作区，并在首次装入该工作区时指向 '^br:/main'。）

== CMD_DESCRIPTION_WORKSPACE_DELETE ==
删除工作区。

== CMD_USAGE_WORKSPACE_DELETE ==
用法：

    cm ^workspace | ^wk ^delete | ^rm [<工作区路径> | <工作区规格>] [--^keepmetadata]

    工作区路径             要删除的工作区的路径。
    工作区规格              要删除的工作区的规格。（使用
                        'cm ^help ^objectspec' 可进一步了解规格。）

选项：

    --^keepmetadata      不删除 .plastic 文件夹中的元数据
                        文件。

== CMD_HELP_WORKSPACE_DELETE ==
备注：

    此命令将删除由路径或规格指定的工作区。
    如果未指定任何参数，则将采用当前工作区。

示例：

    cm ^workspace ^delete
    （删除当前工作区。）

    cm ^wk ^delete c:\workspace
    cm ^workspace rm /home/danipen/wks
    cm ^wk ^rm ^wk:MiWorkspace
    cm ^wk ^rm ^wk:MiWorkspace@DIGITALIS

== CMD_DESCRIPTION_WORKSPACE_LIST ==
列出工作区。

== CMD_USAGE_WORKSPACE_LIST ==
用法：

    cm ^workspace | ^wk [^list | ^ls] [--^format=<格式字符串>]

选项：

    --^format            检索特定格式的输出消息。请参阅
                        “备注”以了解更多信息。

== CMD_HELP_WORKSPACE_LIST ==
备注：

    此命令接受格式字符串以显示输出。
    此命令的输出参数如下：

        {0} | {^wkname}          工作区名称。
        {1} | {^machine}         客户端机器名称。
        {2} | {^path}            工作区路径。
        {3} | {^wkid}            工作区唯一标识符。
        {4} | {^wkspec}          使用以下格式的工作区规格：
                               'wkname@machine'。
        {^tab}                   插入一个制表符空格位。
        {^newline}               插入一个新行。

示例：

    cm ^wk
    （列出所有工作区。）

    cm ^workspace ^list --^format={0}#{3,40}
    cm ^workspace ^list --^format={^wkname}#{^wkid,40}
    （列出所有工作区，并在 40 个空格位中显示工作区名称、# 符号
    和工作区 GUID 字段（左对齐）。）

    cm ^wk --^format="路径 {2} 中的工作区 {0}"
    cm ^wk --^format="路径 {^path} 中的工作区 {^wkname}"
    （列出所有工作区并将结果显示为格式化的字符串。）

== CMD_DESCRIPTION_WORKSPACE_MOVE ==
移动工作区。

== CMD_USAGE_WORKSPACE_MOVE ==
用法：

    cm ^workspace | ^wk ^move | ^mv [<工作区规格>] <新路径>

选项：

    工作区规格              要移动的工作区的规格。（使用
                        'cm ^help ^objectspec' 可进一步了解规格。）
    新路径            工作区将移动到此处。

== CMD_HELP_WORKSPACE_MOVE ==
备注：

此命令允许用户将工作区移动到磁盘上的另一个位置。

示例：

    cm ^workspace ^move myWorkspace \new\workspaceDirectory
    （将 'myWorkspace' 移动到指定位置。）

    cm ^wk ^mv c:\users\maria\wkspaces\newlocation
    （将当前工作区移动到新位置。）

== CMD_DESCRIPTION_WORKSPACE_RENAME ==
重命名工作区。

== CMD_USAGE_WORKSPACE_RENAME ==
用法：

    cm ^workspace | ^wk ^rename [<工作区名称>] <新名称>

    工作区名称             要重命名的工作区。
    新名称            工作区的新名称。

== CMD_HELP_WORKSPACE_RENAME ==
备注：

    此命令将重命名工作区。
    如果未提供工作区名称，则将使用当前工作区。

示例：

    cm ^workspace ^rename mywk1 wk2
    （将工作区 'mywk1' 重命名为 'wk2'。）

    cm ^wk ^rename newname
    （将当前工作区重命名为 'newname'。）

== CMD_DESCRIPTION_WORKSPACESTATUS ==
显示工作区中的更改。

== CMD_USAGE_WORKSPACESTATUS ==
用法：

    cm ^status [<工作区路径>] [--^changelist[=<名称>] | --^changelists] [--^cutignored]
              [ --^header] [ --^noheader] [ --^nomergesinfo] [ --^head]
              [--^short] [--^symlink] [ --^dirwithchanges] [--^xml[=<输出文件>]]
              [--^encoding=<名称>] [ --^wrp |  --^wkrootrelativepaths]
              [--^fullpaths | --^fp] [<旧选项>] [<搜索类型>[ ...]]
              [--^machinereadable [--^startlineseparator=分隔符]
                [--^endlineseparator=分隔符] [--^fieldseparator=分隔符]]

选项：

    工作区路径               要作为搜索范围的工作区的
                          路径。
    --^changelist          显示所选更改列表中的更改。
    --^changelists         显示按客户端更改列表进行分组的更改。
    --^cutignored          跳过已忽略目录的内容。
                          需要 '--^ignored' 搜索类型。请参阅
                          “搜索类型”部分以了解更多信息。
    --^header              仅打印工作区状态。
    --^noheader            仅打印修改后的项搜索结果。
    --^nomergesinfo        不打印更改的合并信息。
    --^head                打印分支上最后一个变更集的状态。
    --^short               仅列出包含更改的路径。
    --^symlink             将操作应用于符号链接而不是
                          目标。
     --^dirwithchanges     显示含有更改的目录
                          （含有已添加、移动、删除的项）。
    --^xml                 以 XML 格式将输出打印到标准输出。
                          可以指定输出文件。
    --^encoding            与 --^xml 选项结合使用，指定要在 XML 输出
                          中使用的编码（例如：utf-8）。
                          请参阅位于以下网址的 MSDN 文档：
                          http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
                          以查看包含受支持编码及其格式的表格
                          （位于页面末尾的“名称”列中）。
     --^wrp                打印工作区根目录的相对路径，而不是
                          当前目录的相对路径。
    --^fullpaths, --^fp     强制打印绝对路径，覆盖所有其他
                          路径打印设置。
    --^machinereadable     以易于解析的格式输出结果。
    --^startlineseparator  与 '--^machinereadable' 标志结合使用，
                          指定行应如何开头。
    --^endlineseparator    与 '--^machinereadable' 标志结合使用，
                          指定行应如何结尾。
    --^fieldseparator      与 '--^machinereadable' 标志结合使用，
                          指定应如何分隔字段。

旧选项：

    --^cset              以旧格式打印工作区状态。
    --^compact           以旧格式打印工作区状态和
                        更改列表。
    --^noheaders         与 '--^compact' 标志结合使用时，不会
                        打印更改列表标题。（不适用于
                        新更改列表格式。）

搜索类型：

    --^added                         打印已添加的项。
    --^checkout                      打印已签出的项。
    --^changed                       打印已更改的项。
    --^copied                        打印已复制的项。
    --^replaced                      打印已替换的项。
    --^deleted                       打印已删除的项。
    --^localdeleted                  打印已在本地删除的项。
    --^moved                         打印已移动的项。
    --^localmoved                    打印已在本地移动的项。
    --^percentofsimilarity=<值>   为了将两个文件视为同一个项而需要
                                    两者之间达到的相似程度百分比。用于
                                    搜索已在本地移动的项。默认值
                                    为 20%。
    --^txtsameext                    在搜索已移动的项期间，
                                    相似性内容匹配过程将
                                    仅考虑具有相同扩展名的
                                    文本文件。默认情况下，
                                    将处理任何文本文件。
    --^binanyext                     在搜索已移动的项期间，
                                    相似性内容匹配过程将
                                    考虑任何二进制文件。默认情况下，
                                    只会处理具有相同扩展名的
                                    二进制文件。
    --^private                       打印非受控项。
    --^ignored                       打印已忽略的项。
    --^hiddenchanged                 打印隐藏的已更改项。（包括
                                    '--^changed'）
    --^cloaked                       打印掩蔽的项。
    --^controlledchanged             此标志替代以下选项：
                                    '--^added'、'--^checkout'、'--^copied'、
                                     '--^replaced'、'--^deleted'、'--^moved'。
    --^all                           此标志替换以下参数：
                                    '--^controlledchanged'、'--^changed'、
                                    '--^localdeleted'、'--^localmoved'、'--^private'。

== CMD_HELP_WORKSPACESTATUS ==
备注：

    '^status' 命令将打印工作区中已加载的变更集，并在工作区
    内获取已更改的元素。

    此命令可用于显示工作区中的待定更改；
    可以使用命令参数来修改可以搜索的
    更改类型。默认情况下将显示所有更改，无论是
    受控更改还是本地更改。

    搜索已在本地移动的项时会使用相似性参数百分比
    '--^percentofsimilarity' (-^p) 来确定两个元素是否为同一个项。
    默认值为 20%，但可以调整。

    可以显示按客户端更改列表分组的工作区更改。
    '^default' 更改列表包括其他更改列表中
    未包含的更改。因此，默认更改列表将显示的更改
    取决于指定的搜索类型标志。

    要显示按更改列表分组的更改，还需要显示受控
    的更改（状态为 '^added'、'^checkout'、'^copied'、
    、'^replaced'、'^deleted' 或 '^moved' 的项）。因此，当显示更改列表时，
    '--^controlledchanged' 选项将自动启用。

    XML 输出的默认编码为 utf-8。

    默认情况下，此命令将打印当前目录的相对路径，
    除非指定了 '--^machinereadable' 或 '--^short' 标志。如果
    指定了其中任何一个标志，该命令将打印绝对路径。

    如果指定了 '--^xml' 标志，则将打印工作区根目录的
    相对路径（除非也指定了 '--^fp' 标志，那么将
    打印绝对路径）。

示例：

    cm ^status
    （打印工作变更集以及工作区中所有已更改的
    项类型，但已忽略的项除外。）

    cm ^status --^controlledchanged
    （打印工作变更集以及已签出、添加、复制、替换、
    删除和移动的项。）

    cm ^status --^added
    （仅打印工作变更集和工作区中添加的项。）

    cm ^status c:\workspaceLocation\code\client --^added
    （以递归方式打印指定路径下的工作变更集和
    添加的项。）

    cm ^status --^changelists
    cm ^status --^changelist
    （显示按客户端更改列表分组的所有工作区更改。）

    cm ^status --^changelist=pending_to_review
    （显示名为 'pending_to_review' 的更改列表中的更改。）

    cm ^status --^changelist=default --^private
    （显示 'default' 更改列表中的更改，包括私有项以及
    具有受控更改的项（如果有）。）

    cm ^status --^short --^changelist=pending_to_review | cm ^checkin -
    （签入更改列表 'pending_to_review' 中的更改。）

    cm ^status C:\workspaceLocation --^xml=output.xml
    （获取 XML 格式的状态信息，并在文件 output.xml 中
    使用 utf-8。）

    cm ^status --^ignored
    （显示所有已忽略的项。）
    输出：
    /main@myrepo@local (^cs:2 - ^head)
    ^Added
        状态     大小       上次修改时间     路径

        ^Ignored    0 字节    19 秒前    out\app.exe
        ^Ignored               48 秒前    src
        ^Ignored    0 字节    48 秒前    src\version.c

    cm ^status --^ignored --^cutignored
    （显示父目录未被忽略的已忽略文件，并显示
    内容未被忽略的已忽略目录。）
    输出：
    /main@myrepo@local (^cs:2 - ^head)
    ^Added
        状态     大小       上次修改时间     路径

        ^Ignored    0 字节    19 秒前    out\app.exe
        ^Ignored               48 秒前    src

== CMD_DESCRIPTION_XLINK ==
创建、编辑或显示 Xlink 的详细信息。

== CMD_USAGE_XLINK ==
用法：

    cm ^xlink [-^w] [-^rs] <Xlink_路径> / (<变更集规格> | <标签规格> | <分支规格)>
             [<扩展规则>[ ...]]
    （创建一个 Xlink。）

    cm ^xlink [-^rs] <Xlink_路径> /<相对路径> (<变更集规格> | <标签规格> | <分支规格>)
             [<扩展规则>[ ...]]
    （创建指向 /<相对路径>（而不是指向默认根目录 /）的只读
    部分 Xlink。）

    cm ^xlink -^e <Xlink_路径> (<变更集规格> | <标签规格> | <分支规格>)
    （编辑 Xlink 以更改目标规格。）

    cm ^xlink -^s|--^show <Xlink_路径>
    （显示 Xlink 信息，包括扩展规则。）

    cm ^xlink -^ar|--^addrules <Xlink_路径> <扩展规则>[ ...]
    （将给定的扩展规则添加到 Xlink。）

    cm ^xlink -^dr|--^deleterules <Xlink_路径> <扩展规则>[ ...]
    （从 Xlink 中删除给定的扩展规则。）

    Xlink_路径          这是当前工作区中将装入（创建 Xlink 时）
                        或已经装入（编辑 Xlink 时）
                        已链接的存储库的目录。
    变更集规格            远程存储库中的完整目标变更集
                        规格。
                        此规格确定了已链接的存储库的工作区中
                        加载了哪个版本和分支。
                        （使用 'cm ^help ^objectspec' 可进一步了解变更集
                        规格。）
    标签规格              远程存储库中的完整标签规格。
                        （使用 'cm ^help ^objectspec' 可进一步了解标签
                        规格。）
    分支规格              远程存储库中的完整分支规格。
                        此规格使用指定的分支所指向的
                        当前变更集。（使用 'cm ^help ^objectspec' 可
                        可进一步了解分支规格。）
    -^e                  编辑现有的 Xlink 以更改目标变更集
                        规格。
    -^s | --^show         显示有关所选 Xlink 的信息。
    -^ar | --^addrules    将一个或多个扩展规则添加到所选 Xlink。
    -^dr | --^deleterules 从所选 Xlink 中删除一个或多个扩展
                        规则。
    扩展规则     指定一个或多个扩展规则。每个扩展
                        规则都是一对分支/目标分支：
                        ^br:/main/fix-^br:/main/develop/fix

选项：

    -^w                  表示 Xlink 是可写的。这意味着
                        可以通过分支自动扩展功能来修改
                        目标存储库的内容。
    -^rs                 相对服务器。此选项允许创建独立于
                        存储库服务器的相对 Xlink。这样，
                        在不同服务器的复制存储库中
                        创建的 Xlink 将被自动识别。

== CMD_HELP_XLINK ==
备注：

    此命令将创建指向给定变更集的 Xlink。默认情况下将创建一个
    只读 Xlink。这意味着无法修改 Xlink 内部工作区中
    加载的内容。为了能够更改通过 Xlink 链接的内容，
    请创建可写的 Xlink（使用 '-^w' 选项）。

    在编辑 Xlink 的目标变更集时，可以使用
    该命令的简化语法。这样，唯一需要的参数是
    新的目标变更集。Xlink 的其余参数将不会
    被修改。

    分支自动扩展：

    在任何可写 Xlink 链接的存储库（'-^w' 选项）中进行更改时，
    需要在目标存储库中创建一个新分支。新分支的
    名称基于顶级存储库中定义的签出
    分支。为了确定要使用的分支的名称，遵循以下规则：

    1) 系统会检查目标存储库中是否存在具有
       相同全名的分支：
         - 如果存在，则将此分支用作签出分支。
         - 如果不存在，则通过以下方式构建分支名称：
           - 通过 Xlink 链接的目标变更集的分支名称 + 签出分支
             的简短名称（最后一部分）。
           - 如果存在此分支，则将此分支用作签出分支。
           - 否则，将创建分支并将分支基项设置为
             通过 Xlink 链接的变更集。

    2) 在父存储库的分支中创建 Xlink 的新版本，
        指向通过 Xlink 链接的存储库中的新变更集。

    最后，完整的 Xlink 结构会与正确版本中的
    最新更改保持同步。

示例：

    cm ^xlink code\firstrepo / 1@first@localhost:8084
    （在当前工作区的文件夹 'firstrepo' 中创建一个 Xlink，
    在其中将装入存储库 'first' 中的变更集 '1'。）

    cm ^xlink opengl\include /includes/opengl 1627@includes@localhost:8087
    （在当前工作区的目录 'opengl\include' 中创建只读
     部分 Xlink，在其中，存储库 'includes' 的变更集 '1627' 中的路径
     '/includes/opengl' 将作为根目录装入。这意味着 '/includes/opengl'
     中的任何内容都将装入到 'opengl\include' 中，
    而存储库的其余部分将被忽略。）

    cm ^xlink -^w -^rs code\secondrepo / ^lb:LB001@second@localhost:8084
    （在当前工作区的文件夹 'secondrepo' 中创建一个
     可写的相对 Xlink，在其中将装入存储库 'second' 中的
    标签 'LB001'。）

    cm ^xlink code\thirdrepo / 3@third@localhost:8087 ^br:/main-^br:/main/scm003
    （在当前工作区的文件夹 'thirdrepo' 中创建一个 Xlink，
    在其中将装入存储库 'third' 中的变更集 '3'。）

    cm ^xlink -^e code\secondrepo ^br:/main/task1234@second@localhost:8084
    （通过链接存储库 'second' 中的分支 'main/task1234'，
    编辑 Xlink 'code\secondrepo' 以更改目标存储库。）

    cm ^xlink --^show code\thirdrepo
    （显示 Xlink 'code\thirdrepo' 的信息，包括其扩展规则
     （如果存在））。

    cm ^xlink -^ar code\secondrepo ^br:/main-^br:/main/develop ^br:/main/fix-^br:/main/develop/fix
    （将两个扩展规则添加到 Xlink 'code\secondrepo'。）

    cm ^xlink -^dr code\secondrepo ^br:/main/fix-^br:/main/develop/fix
    （从 Xlink 'code\secondrepo' 中删除扩展规则）。

== CMD_USAGE_AUTOCOMPLETE ==
用法：

    cm ^autocomplete ^install
    （在 shell 中安装 'cm' 命令补齐功能。）

    cm ^autocomplete ^uninstall
    （从 shell 中卸载 'cm' 命令补齐功能。）

    cm ^autocomplete --^line <shell_行> --^position <光标位置>
    （返回自动补齐建议，以便将“shell_行”插入
     “光标位置”。此命令并非供最终用户使用，但这里记载
     此命令是考虑到您可能需要扩展对所选 shell 的
    自动补齐支持。）

    shell_行      当请求自动补齐时由用户
                    写入 shell 的行。
                    在 Bash 中，此值位于 COMP_LINE 环境变量中。
                    在 PowerShell 中，则位于 $wordToComplete 变量中。
    光标位置 请求自动补齐时的
                    光标位置。
                    在 Bash 中，此值位于 COMP_POINT 环境变量中。
                    在 PowerShell 中，则位于 $cursorPosition 变量中。

== CMD_DESCRIPTION_CONFIGURECLIENT ==
Configures the Plastic SCM client for the current machine user to work with a default server.

== CMD_USAGE_CONFIGURECLIENT ==
用法：
    cm ^configure [--^language=<language> --^workingmode=<mode> [AuthParameters] 
                 --^server=<server> [--^port=<port>]] [--^clientconf=<clientconfpath>]

    --^language          可用语言：
                        en (English)
                        es (Spanish)

    --^workingmode       可用的用户/安全工作模式：
                        NameWorkingMode (Name)
                        NameIDWorkingMode (Name + ID)
                        LDAPWorkingMode (LDAP)
                        ADWorkingMode (Active Directory)
                        UPWorkingMode (User and password)
                        SSOWorkingMode (Single Sign On)

    AuthParameters      身份验证参数（仅适用于 ^LDAPWorkingMode 和 ^UPWorkingMode）：
                        --^user=<user>
                        --^password=<password>

                        Single Sign On parameters (only for ^SSOWorkingMode):
                        --^user=<user>
                        --^token=<token>

    --^server            Plastic SCM server IP / address

    --^port              Plastic SCM server port
                        (port optional for Cloud servers)

    --^clientconf        用于创建配置文件的文件路径（可选）
                        参数可以是完整路径、文件名或目录。

                        示例：

                        --^clientconf=c:/path/to/myclient.conf
                        （指定的路径将用于创建客户端配置文件）

                        --^clientconf=myclient.conf
                        （将使用默认配置目录中的文件 myclient.conf）

                        --^clientconf=c:/exisitingDirectory
                        （将使用指定目录中的默认文件名 client.conf）

== CMD_HELP_CONFIGURECLIENT ==
备注：

    The cm ^configure command cannot be used on Cloud Edition or DVCS Edition of Plastic SCM.
    Use 'plastic --configure' instead.

示例：

    cm ^configure 
    (runs the interactive Plastic SCM client configuration command)

    cm ^configure --^language=^en --^workingmode=^LDAPWorkingMode --^user=^jack --^password=^01234 \
                 --^server=^plastic.mymachine.com --^port=^8084
    (configures the Plastic SCM client with the specified parameters and creates the 'client.conf'
    configuration file in the default directory).
    （Cloud 服务器的可选端口）

    cm ^configure --^language=^en --^workingmode=^NameWorkingMode --^server=^plastic.mymachine.com \
                 --^port=^8084 --^clientconf=^clientconf_exp.conf
    (configures the Plastic SCM client with the specified parameters and creates the 'client.conf'
    configuration file in the specified path).
    （Cloud 服务器的可选端口）